生产环境必须将 APP_DEBUG 设为 false，否则路由缓存失效、SQL 异常堆栈全量暴露、API 响应混入 HTML 片段，AI 网关调用可能触发调试中间件致服务中断；需通过 php think env:debug 确认最终生效值，并同步修改 .env 和 config/app.php 中 debug 配置，关闭 php.ini 的 display_errors，清理日志与路由缓存。
ThinkPHP 8 生产环境必须将 APP_DEBUG 设为 false，否则路由缓存失效、SQL 异常堆栈全量暴露、API 响应体混入 HTML 片段，AI 网关调用时可能触发调试中间件导致服务异常中断。
确认当前 APP_DEBUG 实际值
不要只看 .env 文件里写了什么——ThinkPHP 会按 env → config/app.php → 默认值的优先级合并加载。执行以下命令查看最终生效值：
php think env:debug
输出 true 表示仍处于调试模式，必须立即修正；输出 false 才算真正关闭。这一步跳过会导致后续所有优化失效，因为【APP_DEBUG=true 时路由缓存形同虚设】。
修改 .env 文件（主路径）
方法一：直接编辑项目根目录下的 .env 文件
把 APP_DEBUG=true 改成 APP_DEBUG=false
顺手检查 LOG_LEVEL=debug 是否也改为 LOG_LEVEL=error，避免日志写爆磁盘
方法二：若 .env 不存在或被忽略，需同步修改 config/app.php
找到 'app' => [ ... ] 数组内 'debug' 键，设为 false：'debug' => false
【注意：.env 和 config/app.php 的 debug 配置不能冲突，否则以 .env 为准；但部署时必须确保两者均为 false】
验证 PHP 配置是否配合关闭调试
第一步：检查 php.ini 中 display_errors 是否已关闭
运行 php --ini 查看加载的配置文件路径，编辑对应 php.ini（通常是 /etc/php/8.1/fpm/php.ini）
修复 Core bailout 状态损坏安全问题，以及 BZ2、DOM、PDO、Opcache/JIT 内存与执行错误，改进 Unicode 字素处理、URL 解析、TLS 流状态、信号分发及会话错误处理。
确认以下两行已设置：
display_errors = Off
log_errors = On
第二步：重启 PHP-FPM 使配置生效
sudo systemctl restart php8.1-fpm
第三步：验证响应头是否干净
curl -I http://your-domain.com/api/test → 响应头中不能出现 X-Powered-By: ThinkPHP，该 header 仅在 debug=true 时输出
清理残留调试痕迹
删除 runtime/log/ 下全部 error.log、sql.log 文件
执行 php think clear:route 清除旧路由缓存
再执行 php think route:cache --annotation 重建生产路由缓存
最后检查 runtime/route.php 是否存在且内容非空——这是缓存生效的物理证据
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
