laravel调试模式仅由.env中app_debug控制，必须设为小写true/false，修改后需清缓存；开启时需确保php display_errors=on及app_url匹配，关闭后通过日志和tinker排查问题。
调试模式只在本地开发环境开启，线上必须关闭——Laravel 会直接暴露敏感路径、环境变量和数据库凭证，不是“功能开关”，而是安全红线。
APP_DEBUG 环境变量怎么设才生效
Laravel 的调试模式完全由 .env 文件里的 APP_DEBUG 控制，而不是配置文件或代码里硬编码。它只读取字符串值，且大小写敏感：
-
APP_DEBUG=true→ 开启（注意是小写true，不是True或1） -
APP_DEBUG=false→ 关闭 - 如果
.env不存在或APP_DEBUG被注释/拼错，Laravel 默认按false处理 - 改完后必须清缓存：
php artisan config:clear，否则可能仍用旧值（尤其在 Homestead/Valet 等环境下）
为什么 APP_DEBUG=true 却没看到错误页面
常见于 nginx/apache 配置错误或 PHP 设置冲突：
- Web 服务器返回了 500 但没透出 Laravel 错误页 → 检查
APP_URL是否匹配当前访问域名（不匹配会导致前端资源加载失败，错误页 js/CSS 加载异常，看起来像白屏） - PHP 显示错误被禁用 → 确保
display_errors = On在 php.ini 或php -i | grep display_errors中确认 - 使用了某些中间件（如
TrustProxies）未正确配置 → 导致请求头解析异常，错误捕获链断裂 - 日志里有
WhoopsHandlerPrettyPageHandler not found→ 执行composer require facade/ignition --dev（Laravel 9+ 默认用 ignition，非生产依赖）
APP_DEBUG=false 时如何查问题
关掉调试模式后，所有错误统一返回 500 页面，但日志仍在继续记录：
- 错误详情默认写入
storage/logs/laravel.log，用tail -f storage/logs/laravel.log实时观察 - 想临时看某次请求的完整上下文，可在代码中加
Log::debug('my var:', ['user' => $user]);，比dd()安全 - 不要在生产环境手动改
APP_DEBUG=true测试 —— 即使加了 IP 白名单，也存在缓存、CDN 或代理泄露风险 - 若需类调试体验，可用
php artisan tinker进去手动执行逻辑，或配合Ray（spatie/ray）做无感调试输出
最常被忽略的一点：Laravel 的调试模式和 PHP 的 error_reporting 是两层机制。APP_DEBUG 控制的是「是否渲染 Whoops 页面」，而底层错误是否抛出，还取决于 error_reporting 和 display_errors。两者都得对上，调试才真正可见。