17370845950

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：

• 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() 后加全局异常捕获钩子。