ThinkPHP调试需优先检查.env中APP_DEBUG配置，确保其为true且文件位于根目录；Apache需启用mod_rewrite；自定义异常处理器应调用parent::render()保留堆栈；SQL日志需开启trace/log_sql并保证runtime可写。
ThinkPHP 的调试体验取决于你用的是哪个版本，以及是否启用了正确的配置。5.1 及之后的版本默认开启详细错误提示，但生产环境关闭后容易“黑屏”或 500，让人无从下手。
开启 app_debug 后为什么还是看不到错误？
最常见原因是环境变量覆盖了配置。ThinkPHP 会优先读取 .env 文件中的 APP_DEBUG=true，而不是 config/app.php 里的 app_debug 设置。
-
.env文件必须放在项目根目录（与public/同级），且不能被 Git 忽略却实际缺失 - 如果
.env中写了APP_DEBUG=false，哪怕config/app.php设为true也无效 - Apache 下还需确认
mod_rewrite已启用，否则路由失败可能直接报 404 而非框架错误
think/exception/Handle 自定义异常处理器怎么写才不丢堆栈？
重写 render() 方法时，若直接返回 HTML 字符串或跳转，会丢失原始异常对象和上下文。正确做法是调用父类 render() 获取标准调试页面，再按需包装。
class AppExceptionHandle extends Handle
{
public function render(/Throwable $e): /think/Response
{
// 开发环境保留完整调试页
if (app()->isDebug()) {
return parent::render($e);
}
// 生产环境记录日志 + 返回友好提示
Log::error('Uncaught exception: ' . $e->getMessage());
return response(['msg' => '系统繁忙，请稍后再试'], 500);
}
}
Trace 和日志里看不到 SQL 执行过程？
ThinkPHP 默认只在调试模式下记录 SQL，且需确保数据库配置中开启了 trace 和 log_sql：
立即学习“PHP免费学习笔记（深入）”；
-
database.php中设置'trace' => true（仅 TP6）或'log_sql' => true（TP5.x） - SQL 日志默认写入
runtime/log/，但若runtime目录不可写，日志会静默失败 - 使用
Db::getLastSql()或$query->getLastSql()可在代码中即时获取，适合断点调试
真正难排查的问题往往不是错误没显示，而是错误被中间件、事件监听器或闭包函数吞掉——比如在 middleware 中用了 try/catch 却没重新抛出，或者 Hook::listen() 触发的回调里发生致命错误。这时候得靠 debug_backtrace() 手动打点，或者在 App::init() 后加全局异常捕获钩子。