如何在 ThinkPHP6 控制器中记录异常日志-ThinkPHP-PHP中文网

推荐由异常处理器统一接管日志记录，控制器仅在必要时用Log::channel()补充结构化业务日志，须脱敏敏感字段且不可替代report()职责。

如何在 thinkphp6 控制器中记录异常日志

在 ThinkPHP6 控制器中记录异常日志，不推荐直接在控制器里零散调用 Log::write() 或 try-catch 手动写日志——容易遗漏、结构混乱、无法关联请求上下文，且违背分层职责。真正可靠的做法是：让控制器专注业务，把异常日志交由框架统一的异常处理机制接管，仅在必要时做补充记录。

控制器内需谨慎补充日志的场景

某些业务异常需要额外上下文（如订单号、用户操作链路），可在控制器中主动记录，但必须满足：

使用 Log::channel('xxx') 显式指定日志渠道，避免混入默认日志
日志内容结构化，至少包含：admin_id（或 user_id）、order_no、ip、url、param（已脱敏）
敏感字段（如 password、token、card_no）必须过滤或替换为 [REDACTED]
不替代 report() 职责，只作增强，不处理堆栈、不触发告警

例如：

use think\facade\Log;

try {
    $order = OrderService::create($data);
} catch (BusinessException $e) {
    Log::channel('business')->error('订单创建失败', [
        'order_no' => $data['order_no'] ?? '',
        'user_id'  => session('user_id'),
        'ip'       => request()->ip(),
        'url'      => request()->url(),
        'message'  => $e->getMessage(),
        'code'     => $e->getCode(),
        'params'   => array_filter($data, function($k) {
            return !in_array($k, ['password', 'token']);
        }, ARRAY_FILTER_USE_KEY),
    ]);
    throw $e; // 仍需抛出，交由 Handler 统一上报
}

真正起效的日志记录不在控制器，而在 `Handler.php`

控制器不是异常日志的主战场。ThinkPHP6 的异常日志核心逻辑应放在 app/exception/Handler.php 中：

btpanel phpsite 宝塔面板PHP网站

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

下载

report() 方法负责记录与上报：判断是否需上报、写入本地日志、推送至 Sentry/ARMS 等
render() 方法只负责响应输出：返回 JSON 或视图，不执行任何 I/O 操作

关键配置要点：

在 shouldReport() 中排除预期异常（如 ValidateException、HttpException 404/405）
report() 中对 Error 类型（如 ParseError、FatalError）显式处理，TP6.1 默认不捕获

$dontReport 数组明确声明无需日志的类：

protected $dontReport = [
    ValidateException::class,
    TokenExpiredException::class,
    \think\exception\HttpException::class, // 404/405 等不记为错误
];