Laravel部署后500错误主因是.env未正确配置、配置缓存残留及storage/bootstrap/cache权限不当；需设APP_DEBUG=false、执行config:cache前确保APP_KEY有效，并将storage和bootstrap/cache设为775且属组www。
将Laravel项目从本地开发环境推送到生产服务器后，页面直接报500错误、路由失效、权限判断变慢或完全不生效——这不是代码写错了，而是部署环节漏掉了关键权限设置和缓存初始化步骤。
确认并修正核心环境配置
第一步不是改代码，而是确保.env文件已按生产环境要求重写。打开项目根目录下的.env文件，逐行核对：
APP_ENV=production
APP_DEBUG=false
APP_URL=https://yourdomain.com
CACHE_DRIVER=redis
SESSION_DRIVER=redis
QUEUE_CONNECTION=redis
【APP_DEBUG必须设为false且在首次访问前完成】，否则调试信息会暴露在页面上，且php artisan config:cache等命令会因环境未识别为production而拒绝执行。
修改完保存，用终端进入项目根目录，运行：
php artisan tinker → 输入config('app.debug')，返回false才算生效。
重建配置与路由缓存
迁移或更新后，bootstrap/cache/config.php极易残留旧配置，导致框架初始化失败并静默500。执行以下命令清空并重建：
rm -f bootstrap/cache/*.php
php artisan config:clear
php artisan cache:clear
php artisan view:clear
php artisan config:cache
注意：执行config:cache前，必须确认.env中APP_KEY已存在且未被注释。若尚未生成，先运行php artisan key:generate。
路由缓存只对routes/web.php和routes/api.php中顶层静态声明的Route::get等生效，闭包路由和Route::fallback()会被静默丢弃。执行php artisan route:cache后，务必用php artisan route:list比对缓存前后输出，确认关键路由是否仍在列表中。
修复storage与bootstrap/cache目录权限
权限不是越宽越好，777是安全隐患。正确做法分三步：
① 确保所有文件归组www（宝塔默认PHP/Nginx运行用户）：
chown -R www:www /www/wwwroot/your_project
② 批量设置基础权限：
find /www/wwwroot/your_project -type d -exec chmod 755 {} \;
find /www/wwwroot/your_project -type f -exec chmod 644 {} \;
③ 重点保障可写目录：
chmod -R 775 storage bootstrap/cache
【在宝塔文件管理器中修改权限时，务必手动选择用户组为www，不能只改数字】。public目录保持755即可，无需可写。
启用Laravel Permission缓存并验证
如果你使用了spatie/laravel-permission包，权限检查默认缓存24小时。但部署后首次运行需手动触发加载：
php artisan permission:cache-reset
该命令本质是artisan cache:forget spatie.permission.cache，但它更安全可靠。执行后，权限数据会重新从数据库加载并写入缓存。
若你已自定义缓存过期时间，在config/permission.php中检查：
'cache' => [
'expiration_time' => DateInterval::createFromDateString('12 hours'),
]
频繁变动权限的环境建议设为1–2小时；稳定环境可用24小时。使用Redis存储权限缓存可避免键冲突，配置项为'store' => 'redis'。
验证权限判断是否走缓存
在控制器中插入测试逻辑：
dd(Gate::inspect('edit articles')->allowed());
刷新页面，观察响应时间是否显著低于首次。若仍慢，检查config/auth.php中guards配置是否启用了session驱动，且cache driver支持原子操作（如redis）。
如果权限变更后用户界面未即时更新，说明缓存未自动失效。此时需确认模型是否使用了RefreshesPermissionCache trait，或手动调用：
app()->make(\Spatie\Permission\PermissionRegistrar::class)->forgetCachedPermissions();
