ThinkPHP6.0调试模式通过.env文件设置APP_DEBUG=true开启,开发时必须启用、上线前必须关闭;开启后显示完整错误堆栈和Trace图标,关闭可防止敏感信息泄露。

ThinkPHP6.0 开启调试模式主要靠环境变量控制,核心是设置 APP_DEBUG=true。它不是改代码开关,而是通过配置文件生效,开发阶段必须开,上线前务必关。
修改 .env 文件(最常用)
项目根目录下找 .example.env 文件,直接重命名为 .env(注意前面的点不能丢)。用文本编辑器打开,确保有这一行:
- APP_DEBUG=true
- 如果该行被注释(前面有 #),删掉 # 号
- 没有这行就手动添加在文件开头或 [APP] 区块下
- 保存后无需重启 Web 服务,刷新页面即可生效
检查 config/app.php 配置(辅助确认)
虽然调试模式由 .env 主控,但以下两项也影响错误显示效果:
- 'show_error_msg' => true:即使关闭调试模式,也能看到具体错误信息(仅限开发环境使用,生产环境禁用)
- 'app_debug' => env('APP_DEBUG', true) 这行通常已存在,表示从 .env 读取值,不用改动
验证是否开启成功
开启后会出现明显特征:
立即学习“PHP免费学习笔记(深入)”;
- 报错页面显示完整堆栈、文件路径、参数和环境信息
- 页面右下角出现 ThinkPHP Trace 图标(小LOGO + 执行时间)
- 点击图标可查看「基本」「SQL」「错误」「调试」等实时追踪面板
- 模板修改无需清缓存即刻生效
上线前必须关闭
部署到生产环境时,务必将 .env 中的 APP_DEBUG=false,否则会暴露敏感路径、数据库配置甚至环境变量,造成严重安全隐患。关闭后错误页仅显示通用提示,更安全也更规范。



















