Laravel 500错误应优先开启调试模式（APP_DEBUG=true）暴露真实异常，再清空并重建配置缓存（尤其bootstrap/cache/config.php），确认APP_KEY有效、权限正确（storage和bootstrap/cache设775、用户组为www）、PHP版本及扩展（openssl/pdo/mbstring等）符合要求。
遇到 Laravel 500 报错，别急着重装或改权限。多数情况是配置、缓存或环境没对齐，而不是代码本身出问题。核心思路是：让错误“露出来”，再一层层往里查。
打开调试模式，看清真实报错
这是最快速有效的第一步。修改项目根目录下的 .env 文件：
- APP_DEBUG=true
- APP_ENV=local
保存后刷新页面，如果配置生效，你会看到完整的异常堆栈（比如类未找到、方法不存在、SQL语法错误等）。注意：只在开发/测试环境开启，上线前必须关掉。验证是否真生效，可在终端运行：
php artisan tinker然后输入：config('app.debug')，返回 true 才算成功。
清空并重建配置缓存
迁移项目、更新 .env 或换服务器后，bootstrap/cache/config.php 这个文件极易残留旧配置，导致框架初始化失败，直接 500 且不写日志。执行以下命令：
Laravel Cloud
下载
Laravel Cloud（cloud.laravel.com）。此技能用于处理所有 Laravel Cloud 请求，包括搜索和读取数据。只要任务涉及 Laravel Cloud，即使用此技能。
- rm -f bootstrap/cache/*.php
- php artisan config:clear
- php artisan cache:clear
- php artisan view:clear
- php artisan config:cache（执行前确认 .env 中 APP_KEY 已存在且未被注释）
如果 php artisan key:generate 没跑过，先补上；否则 config:cache 会失败并引发新 500。
检查关键目录权限与用户归属
权限不是越宽越好，777 是安全隐患。正确做法是：
- 确保所有文件归组 www（宝塔默认 PHP/Nginx 运行用户）：chown -R www:www /www/wwwroot/your_project
- 目录设为 755，文件设为 644（用 find 批量处理）
- 重点保障可写目录：storage 和 bootstrap/cache 必须是 775
- public 目录保持 755 即可，无需可写
在宝塔文件管理器中修改权限时，务必手动选择用户组为 www，不能只改数字。
验证 PHP 环境与扩展
Laravel 对 PHP 版本和扩展有硬性要求。常见踩坑点：
- 确认 PHP 版本满足当前 Laravel 版本最低要求（如 Laravel 8.74+ 需 PHP ≥ 8.0.2）：php -v
- 检查必需扩展是否启用：php -m | grep -E 'openssl|pdo|mbstring|tokenizer|json|xml'
- 阿里云等平台可能默认禁用 OpenSSL：php --ini 查配置路径，确认 extension=openssl.so 已加载
- 若用 Nginx + PHP-FPM，检查 fastcgi_param 是否透传了环境变量（有些面板脚本会覆盖 APP_DEBUG）
