thinkphp6调试模式必须在public/index.php首行用define('app_debug', true)显式定义，同时清除runtime缓存、配置debug_show_exception为true，并重写exception.php的render()方法适配json请求，三者缺一不可。
ThinkPHP6 的 APP 调试模式不是改一个配置就能生效的，它必须满足「入口级常量定义」+「环境变量加载时机」+「异常响应格式适配」三者协同，缺一不可。只改 .env 或只配 config/app.php，大概率看到的是空白页、500 或 HTML 错误页——尤其是调 API 时。
入口文件必须第一行 define('APP_DEBUG', true)
这是唯一权威生效的位置，TP6 不认 config/app.php 里的 app_debug，也不看 URL 参数或运行时 putenv()。常见错误包括：
- 在
require框架启动文件之后才写define('APP_DEBUG', true)—— 此时框架已初始化，开关无效 - 入口文件顶部有 BOM、空行、注释或
ini_set()—— PHP 解析失败，define不执行 - 写成
define('APP_DEBUG', 'true')或define('APP_DEBUG', 1)—— TP6 严格判断布尔值，字符串/数字会被当作 false
正确做法：打开 public/index.php，在 <?php 后**立刻**插入一行：
define('APP_DEBUG', true);
然后删掉 runtime/ 目录下所有内容（含 ~runtime.php），否则缓存会掩盖配置变更。
API 请求不显示错误堆栈？检查 Accept 头和 render() 方法
即使 APP_DEBUG = true，TP6 默认异常处理器仍按请求头决定返回格式。Postman、fetch、axios 默认发 Accept: application/json，但官方 render() 若没覆盖 JSON 场景，就会返回空响应或 500 页面，根本看不到报错。
- 确认
app/exception.php继承自\think\exception\Handle - 重写
render()方法，在开头加判断：if ($request->isAjax() || $request->header('accept') === 'application/json') - 内部用
json(['error' => $e->getMessage(), 'file' => $e->getFile(), 'line' => $e->getLine(), 'trace' => $e->getTraceAsString()], 500)强制输出 - 别忘了顶部
use think\Response;，否则json()函数不可用
不这么做，curl -H "Accept: application/json" http://localhost/api/test 就永远只有空白或 500。
APP_DEBUG=true 却还是没反应？排查三个隐藏关卡
调试开关被“静默屏蔽”是高频问题，重点查这三项：
-
php.ini或入口文件里没开display_errors：在public/index.php顶部define()后加ini_set('display_errors', '1'); - Nginx 配置中
fastcgi_intercept_errors on;：必须设为off，否则 Nginx 会吞掉 TP6 渲染的错误页，只返回 500 -
config/app.php中'debug_show_exception' => true缺失：TP6+ 默认不显示详细异常页面，这个配置只在APP_DEBUG === true时读取，不配就白开
验证是否真生效：在控制器里写 dd(undefine_var);，看页面是否爆出完整堆栈，而不是“系统繁忙”或空白。
.env 和入口 define 冲突时谁赢？
.env 文件只在入口文件**没显式定义** APP_DEBUG 时才起作用。一旦你在 public/index.php 里写了 define('APP_DEBUG', true)，.env 里的 APP_DEBUG=false 就完全失效——但反过来，如果 .env 里是 APP_DEBUG=true，而入口文件没写 define，那它就生效。
-
.env必须是 UTF-8 无 BOM 编码，等号两侧不能有空格，例如APP_DEBUG=true✅，APP_DEBUG = true❌ - 修改
.env后必须重启 PHP-FPM/Swoole 进程，OPCache 开启时还要opcache_reset()或设opcache.revalidate_freq=0 - 线上部署务必删掉
.env文件，不能只靠改值——TP6 在文件不存在时 fallback 到true，非常危险
最稳的开发习惯：入口文件写 define('APP_DEBUG', true)，上线前删掉这一行，并确保 .env 不存在或明确写 APP_DEBUG=false。任何依赖“自动识别”的路径，都容易在跨环境时翻车。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
