如何正确设置ThinkPHP关闭调试模式及Debug开关？

本文共计889个文字，预计阅读时间需要4分钟。

测试模式未开启，90%+的情况不是没有写，而是它被覆盖、被忽略，或者根本没生效。

入口文件 define('APP_DEBUG', true) 写错位置

ThinkPHP 在 require 框架启动文件（如 thinkphp/base.php）前就检查 APP_DEBUG 常量。一旦错过这个时机，后面怎么改都无效。

• ✅ 正确：在 public/index.php 最顶部、<?php 后立即写 define('APP_DEBUG', true);
• ❌ 错误：写在 require __DIR__ . '/../vendor/autoload.php'; 之后，或写在控制器、中间件里
• ❌ 错误：在 config/app.php 里设 'app_debug' => true —— 这个配置只在 APP_DEBUG === true 时才被读取，单独设它等于没设

.env 文件的 APP_DEBUG 被代码硬编码覆盖

.env 中的 APP_DEBUG=true 只是 fallback 方案：只有当 PHP 代码中完全没定义 APP_DEBUG 常量时，框架才会去读它。只要入口文件写了 define('APP_DEBUG', false)，.env 就彻底失效。