需在public/index.php顶部定义APP_DEBUG常量为true以启用调试日志，否则日志不生成或内容缺失。
如果您在ThinkPHP项目开发中需要记录Debug调试信息，但发现日志未生成或内容缺失，则可能是由于调试信息记录开关未正确启用或配置路径错误。以下是解决此问题的步骤：
一、在入口文件顶部定义APP_DEBUG常量
ThinkPHP的调试信息记录功能依赖于APP_DEBUG常量的启用状态，该常量必须在public/index.php文件最开始处、
1、打开项目根目录下的public/index.php文件。
2、确保文件开头为<?php，且其后第一行即为define('APP_DEBUG', true);。
立即学习“PHP免费学习笔记（深入）”；
3、确认该语句前无任何输出（包括空格、BOM头、echo、var_dump等），否则会导致PHP报错并中断执行。
4、保存文件后刷新页面，检查是否出现调试工具栏及错误堆栈信息。
二、配置日志记录参数与级别
仅开启APP_DEBUG不足以保证所有调试信息写入日志，还需确保日志系统已启用并允许DEBUG级别记录。LOG_RECORD控制是否启用日志写入，LOG_RECORD_LEVEL决定哪些类型的信息可被记录。
1、打开config/app.php配置文件（ThinkPHP 6+）或conf/config.php（ThinkPHP 5.x）。
2、添加或修改以下配置项：
'LOG_RECORD' => true,
'LOG_RECORD_LEVEL' => ['EMERG','ALERT','CRIT','ERR','WARN','NOTIC','INFO','DEBUG','SQL'],
3、若使用ThinkPHP 6，还需确认config/log.php中默认channel的type为File，且level包含debug。
4、确保runtime/log/目录存在且具有写入权限（Linux下通常需chmod 755或777）。
三、使用Log::debug()或Log::write()主动写入调试日志
在业务逻辑中插入调试日志时，需注意方法调用前提：APP_DEBUG必须为true，且当前日志channel的level白名单包含debug。Log::debug()本质是Log::write('debug', $msg)，受双重限制。
1、在控制器或服务类中引入日志门面：use think\facade\Log;。
2、插入调试语句：Log::debug('用户ID为：' . $userId);。
3、若需指定channel（如stdout），应使用Log::channel('stdout')->debug('CLI调试信息');（仅TP6.0.10+支持）。
4、检查runtime/log/目录下是否生成对应日期的log文件，并确认其中包含刚写入的debug内容。
四、启用页面Trace调试面板
页面Trace功能独立于日志文件记录，用于在网页底部显示运行时间、内存、SQL、请求参数等实时调试信息，需显式开启SHOW_PAGE_TRACE并确保APP_DEBUG为true。
1、在config/app.php中设置：'SHOW_PAGE_TRACE' => true,。
2、确认'APP_DEBUG' => true已在入口文件定义，而非仅配置文件中。
3、访问任意HTTP接口，观察页面右下角是否出现灰色调试工具栏。
4、如需自定义Trace内容，可在应用配置目录新建trace.php文件，返回关联数组供Trace面板读取。
五、验证PHP底层错误报告设置
即使ThinkPHP调试模式开启，若PHP自身禁用了错误显示或报告，调试信息仍无法呈现。APP_DEBUG依赖error_reporting和display_errors的实际生效值才能触发完整堆栈输出。
1、检查php.ini中是否设置display_errors = On和error_reporting = E_ALL。
2、Nginx + PHP-FPM环境下，确认fastcgi_params未通过php_flag display_errors off覆盖设置。
3、Docker环境中，检查PHP镜像启动参数或docker-php-ext-enable是否遗漏了错误显示模块。
4、在入口文件顶部临时添加ini_set('display_errors', '1'); error_reporting(E_ALL);进行强制启用验证。
