Common Issues

Common Issues

500 Internal Server Error

Cause: Usually a misconfigured .env file or missing permissions.

Solution:

• Check storage/logs/laravel.log for the detailed error
• Ensure storage/ and bootstrap/cache/ are writable
• Verify database credentials in .env
• Run php artisan config:clear

Images Not Loading

Cause: Storage symlink not created.

Solution:

php artisan storage:link

Blank White Page

Cause: PHP error with display_errors disabled.

Solution:

• Temporarily set APP_DEBUG=true in .env
• Check PHP error logs
• Common fix: composer install to restore dependencies

Slow Page Loading

Cause: Missing optimization.

Solution:

php artisan config:cache
php artisan route:cache
php artisan view:cache
composer install --optimize-autoloader --no-dev

> [!TIP] Enable Redis caching for significant performance improvements.

> [!WARNING] Always set APP_DEBUG=false after debugging in production.