Owner: Dev Team | Last Updated: 2026-02-21 | Status: Current
Resolving common issues during development and operations.
| Problem |
Cause |
Solution |
Vite manifest not found |
Frontend not built |
Run npm run dev or npm run build |
SQLSTATE[HY000] [2002] |
MySQL not running |
sudo systemctl start mysql or docker-compose up -d db |
ECONNREFUSED on Redis |
Redis not running |
sudo systemctl start redis |
Class not found |
Autoload outdated |
composer dump-autoload |
Permission denied on storage |
File permissions |
chmod -R 775 storage bootstrap/cache |
Port 8000 in use |
Port occupied |
php artisan serve --port=8001 |
419 Page Expired |
CSRF token expired |
Refresh the page |
npm install fails |
Incompatible Node.js |
Use Node.js >= 18.17.0 |
vue-tsc errors |
TypeScript errors |
Fix the types or use npm run dev (without type check) |
Circular dependency |
Circular dependencies |
Run npm run check-deps |
| Problem |
Cause |
Solution |
| Migration fails |
Table already exists |
php artisan migrate:fresh --seed (dev only!) |
| Slow queries |
Missing indexes |
Check EXPLAIN for the query |
| Connection refused (Docker) |
Wrong port |
Docker maps MySQL to 3307, set DB_PORT=3307 |
Access denied |
Wrong credentials |
Check DB_USERNAME and DB_PASSWORD in .env |
| Problem |
Cause |
Solution |
| Stale data |
Cache not invalidated |
php artisan cache:clear |
| Config cached |
Outdated configuration |
php artisan config:clear |
| Route cached |
Outdated routes |
php artisan route:clear |
| View cached |
Outdated templates |
php artisan view:clear |
php artisan cache:clear && php artisan config:clear && php artisan route:clear && php artisan view:clear
| Problem |
Cause |
Solution |
| Payment fails |
Test card |
Use 4242424242424242 for testing |
| Webhook not received |
Endpoint not configured |
Configure the webhook in Stripe Dashboard |
| Webhook verification fails |
Wrong secret |
Update STRIPE_WEBHOOK_SECRET |
| Local webhook testing |
No public URL |
Use stripe listen --forward-to localhost:8000/webhook/stripe |
| Problem |
Cause |
Solution |
| Jobs not processing |
Worker not running |
php artisan queue:listen |
| Job fails repeatedly |
Error in code |
Check storage/logs/laravel.log |
| Job stuck |
Worker hung |
Restart worker: php artisan queue:restart |
| Problem |
Cause |
Solution |
| 500 error |
APP_DEBUG=false hides errors |
Check storage/logs/laravel.log |
| Assets 404 |
Build not completed |
npm run build on the server |
| Scheduler not working |
Cron not configured |
Add a cron job for schedule:run |
| Queue stopped |
Supervisor not configured |
Configure Supervisor |
¶ Useful Commands
# Full clear and rebuild
php artisan optimize:clear
composer dump-autoload
npm run build
# Check configuration
php artisan about
# Check routes
php artisan route:list
# Check scheduled tasks
php artisan schedule:list
# Check queue
php artisan queue:monitor default
# Check circular dependencies
npm run check-all-deps
| Date |
Author |
Change |
| 2026-02-21 |
Documentation Team |
Initial creation |
Prev: Monitoring | Up: Deployment