关闭调试模式后报错不可见是ThinkPHP的安全机制，需开启日志记录（配置log.level为['error','sql']）、确保runtime/logs目录可写，并检查PHP底层error_log是否启用，才能准确定位问题。
关闭调试模式后报错看不到具体信息，是因为 ThinkPHP 默认在部署模式下隐藏了错误详情，只显示“页面错误！请稍后再试～”这类提示。这不是故障，而是安全机制——但确实给排查带来困难。关键不是恢复页面报错，而是让错误可查、可定位。
开启错误日志记录
这是最可靠的方式。即使不显示错误页面，只要日志能写入，就能还原问题：
- 确认 Runtime/Logs/ 目录存在且有写权限（Linux 下常用
chmod -R 755 Runtime） - 检查配置文件（如
app.php或database.php）中是否启用了日志：'log' => ['level' => ['error', 'sql']] - 出错后立即查看
Runtime/Logs/年_月/日.log，里面会包含文件、行号、异常消息等完整上下文
临时启用错误信息显示
仅用于紧急排查，上线前必须关闭：
- 在配置中添加：
'SHOW_ERROR_MSG' => true（ThinkPHP 3.x）或'show_error_msg' => true（TP5/6） - 注意：该设置仅在
APP_DEBUG = false时生效，且不会暴露敏感路径（如绝对路径会被脱敏） - 若仍不显示，检查是否被服务器 PHP 配置覆盖——确认
display_errors = Off（线上应为 Off），但框架层的SHOW_ERROR_MSG是独立控制的
避免“报错消失却无日志”的陷阱
有些错误根本不会进日志，比如语法错误、类未加载、函数重名等，它们发生在框架初始化之前：
立即学习“PHP免费学习笔记（深入）”；
-
Parse error 类报错：检查
php.ini中short_open_tag = On（尤其 TP3.x 使用短标签模板时） -
Class not found：常见于关闭调试后自动加载失效，确认命名空间、文件路径是否用全路径（如改
require 'xxx.php'为require APP_PATH . 'Common/xxx.php'） -
Controller 方法名冲突：如自定义了
show()、redirect()等与基类同名方法，关闭调试后会覆盖导致 fatal error
用 SQL 日志辅助定位逻辑异常
某些问题看似报错，实则是查询行为异常（比如总返回第一条数据），这类问题页面无报错但结果错误：
- 在配置中开启 SQL 日志：
'db_debug' => true（TP3.x）或'debug' => true（TP5/6 的数据库配置） - 或手动在查询前后写日志：
file_put_contents('./query.log', $Model->getLastSql()."\n", FILE_APPEND); - 对比调试模式与非调试模式下的 SQL 差异，常能发现缓存未清除、条件拼接错误等问题
