ThinkPHP版本怎么开启调试模式查看错误详情-ThinkPHP-PHP中文网

必须在入口文件顶部用 define('app_debug', true) 硬编码开启调试，且须为布尔值、无空行/输出、多入口需各自添加，并清空 runtime 目录；.env 中配置优先级低，常被忽略；还需配合 php 错误显示、app_trace、sql 日志等子开关及权限配置。

thinkphp版本怎么开启调试模式查看错误详情

必须在入口文件顶部用 define('APP_DEBUG', true) 硬编码开启，其他方式（如改 config/app.php 或只配 .env）在多数场景下会静默失效。

ThinkPHP 5.x/6.x/8.x 全部版本都只认这个常量，且检查时机极早——框架加载前就判断。一旦位置错、类型错或被覆盖，调试功能（异常堆栈、SQL 日志、Trace 面板）全部不出现。

public/index.php（TP6/8）或 index.php（TP5）最顶部，<?php 后立即写，不能有任何 require、include、输出或空行
必须是布尔值：define('APP_DEBUG', true)；写成 'true'、1、'1' 全部无效
多入口（如 admin.php、api.php）需各自单独加这一行
加完后务必删掉整个 runtime/ 目录（含子目录和 ~runtime.php），否则旧缓存会掩盖新配置

.env 是后备方案，优先级低于代码中 define()。只要入口文件写了 define('APP_DEBUG', ...)，.env 里那行就彻底被忽略——哪怕你写的是 false，也不会关掉调试。

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

常见误操作：开发时配了 .env，上线又加了 define('APP_DEBUG', false)，结果测试环境还显示 Trace 面板，八成是 runtime/ 没清干净
.env 文件必须 UTF-8 无 BOM 编码，等号两侧不能有空格：APP_DEBUG=true ✅，APP_DEBUG = true ❌
TP6+ 要让右下角 Trace 面板出来，光有 APP_DEBUG=true 不够，还得配 APP_TRACE=true 并安装 topthink/think-trace 扩展

ThinkPHP 的调试页面依赖 PHP 底层把错误吐出来。如果 PHP 自己屏蔽了错误（比如 Nginx + PHP-FPM 默认行为），APP_DEBUG 就是摆设。

在 define('APP_DEBUG', true) 后立刻加两行：ini_set('display_errors', '1'); 和 error_reporting(E_ALL);
Nginx 环境必须确认 fastcgi_intercept_errors off;，否则 Nginx 会把 PHP 错误页吞成 500
Docker 或共享主机常见问题：镜像默认关了 display_errors，只改 PHP 代码没用，得进容器改 php.ini 或启动时注入
CLI 场景（如 php think route:list）不会显示调试页面，需加 -v 参数才输出完整异常

APP_DEBUG=true 只是总闸，具体能力要单独启用。TP6/8 把 SQL 日志、Trace、模板编译等拆得很细，漏一个就缺一块信息。

SQL 日志：数据库配置（config/database.php）里必须设 'log_sql' => true（TP5）或 'trace' => true（TP6+），且 runtime/log/ 目录要可写
Trace 面板：除了 APP_TRACE=true，还要确保中间件没拦截异常——自定义 think\exception\Handle 类时，render() 方法里必须调用 parent::render($e)
想看真实执行的 SQL（带表前缀、软删除条件、时间转换等），别用 Db::getLastSql()，改用监听：Db::listen(function ($sql, $time, $explain) { dump($sql); });