必须立即启用app_debug=true暴露错误，清空并重建配置缓存（含config:cache前确保app_key有效），修正storage和bootstrap/cache权限为775且用户组为www，验证php版本及必需扩展（openssl/pdo/mbstring等）是否就绪。
当Laravel应用因配置错误、缓存污染或权限异常导致500报错无法访问时，必须在10分钟内恢复服务，不能等待重新部署或人工逐行排查代码。
立即启用调试模式暴露真实错误
打开项目根目录下的.env文件，将APP_DEBUG和APP_ENV两行改为：
APP_DEBUG=true
APP_ENV=local
保存后刷新页面，若看到完整异常堆栈（如Class 'App\Http\Controllers\XXX' not found），说明调试已生效；若仍显示空白页或通用500，则说明Web服务器未正确加载.env变更，需重启PHP-FPM或Nginx。
【APP_DEBUG=true仅限临时排障，切勿在生产环境长期开启】
清空全部缓存并重建配置
执行以下命令顺序执行，中间不可跳步：
rm -f bootstrap/cache/*.php → php artisan config:clear → php artisan cache:clear → php artisan view:clear → php artisan config:cache
最后一步php artisan config:cache会读取.env生成新的bootstrap/cache/config.php。若此前未生成APP_KEY，此命令会失败并报错“Key path does not exist”，此时必须先运行php artisan key:generate再重试config:cache。
执行完成后，检查bootstrap/cache/config.php文件是否真实生成且内容非空——这是判断缓存重建是否成功的唯一依据。
修复storage与bootstrap/cache目录权限
方法一：终端批量修正（推荐）
chown -R www:www /path/to/your/laravel/project
find /path/to/your/laravel/project/storage -type d -exec chmod 775 {} \;
find /path/to/your/laravel/project/bootstrap/cache -type d -exec chmod 775 {} \;
方法二：宝塔面板手动操作
进入文件管理 → 选中storage和bootstrap/cache两个目录 → 右键“权限设置” → 数字权限填775 → 用户组下拉框必须选择www（不是nobody或root）→ 勾选“递归设置” → 提交。
注意：public目录只需755，无需可写权限；chmod 777是严重安全隐患，禁止使用。
验证PHP扩展与版本兼容性
第一步：确认PHP版本满足当前Laravel要求
php -v
第二步：检查必需扩展是否启用
php -m | grep -E '^(openssl|pdo|mbstring|tokenizer|json|xml|ctype|bcmath)$'
若输出缺失任意一项（如无openssl），需编辑php.ini启用对应扩展：
extension=openssl.so（Linux）或 extension=php_openssl.dll（Windows）
修改后必须重启PHP-FPM进程，否则扩展不生效。
