可在Handler的report()中用instanceof判断异常类型，调用Log::channel('xxx')->error()写入预定义的自定义通道，同时保留parent::report($exception)兜底；无需修改日志配置文件，避免手动拼接日志或耗时操作。
如何在 Laravel 中让不同异常写入不同日志文件
直接改 App\Exceptions\Handler 的 report() 方法即可，不用动配置文件或重写日志通道。Laravel 本身不区分异常类型写日志，但你可以用 instanceof 判断异常类，再调用对应日志通道的 channel()->error() 等方法。
关键点是：别试图在 config/logging.php 里为每种异常预定义通道——那样会失控；而是按需动态选通道，保持日志配置干净。
- 自定义通道（如
payment、api）需在config/logging.php中提前声明，使用single驱动并指定path - 在
Handler@report()中用Log::channel('xxx')->error(...)显式写入，绕过默认日志流程 - 务必保留
parent::report($exception)对非目标异常的兜底处理，否则 404、ValidationException 等可能丢失
常见异常类型怎么识别和分流
不是所有异常都值得单独归档。优先处理业务强相关、需监控或排查链路长的异常，比如支付失败、第三方 API 超时、数据库死锁。Laravel 自带的 ModelNotFoundException 或 AuthorizationException 通常不需要拆日志，除非你有特殊审计需求。
判断逻辑建议写在 report() 开头，用清晰的 if-elseif 链，避免嵌套：
if ($exception instanceof \Stripe\Exception\CardException) {
\Log::channel('payment')->error("Stripe card error: {$exception->getMessage()}", [
'code' => $exception->getCode(),
'stripe_code' => $exception->getStripeCode()
]);
} elseif ($exception instanceof \GuzzleHttp\Exception\ConnectException) {
\Log::channel('external_api')->warning("API timeout or connect failed", [
'url' => $exception->getRequest()?->getUri(),
'message' => $exception->getMessage()
]);
} else {
parent::report($exception);
}
为什么不能直接覆盖 context 或修改 report() 返回值
Laravel 日志上下文（context）是扁平数组，没法靠它自动路由到不同文件；而 report() 方法本身无返回值，返回任何东西都没意义。有人试过在 report() 里 return false 来阻止默认记录，这会导致异常完全不进日志——Laravel 不会帮你 fallback，parent::report() 被跳过就真的没了。
Laravel Cloud（cloud.laravel.com）。此技能用于处理所有 Laravel Cloud 请求，包括搜索和读取数据。只要任务涉及 Laravel Cloud，即使用此技能。
真正可控的出口只有两个：Log::channel('xxx') 显式写入，或抛出新异常触发另一轮 report()（不推荐，易循环）。
- 别碰
$exception->getTraceAsString()手动拼日志——格式和敏感信息（如密码、token）难控制 - 不要在
report()里做耗时操作（如发 Slack、写 DB），会拖慢整个请求生命周期 - 测试时用
php artisan tinker模拟抛异常，确认日志文件是否生成且内容可读
生产环境要注意的路径与权限问题
自定义日志路径（如 storage/logs/payment.log）必须被 Laravel 进程可写，且目录存在。Laravel 不会自动创建多级子目录，storage/logs/payment/ 这种路径要手动 mkdir -p，否则报错 Failed to open stream: No such file or directory。
日志文件权限建议设为 644，属主为运行 Web 服务的用户（如 www-data 或 nginx）。如果用 Supervisor 管理队列，还要确保队列进程用户也有相同写权限。
- 别把日志写到
/tmp或根目录下——不符合 Laravel 约定，也难备份 - 避免在日志文件名中加入日期（如
payment-2024-06.log），Laravel 的daily驱动才管轮转，single驱动只认固定文件名 - 上线前检查
storage/logs/下是否有残留的.log文件被其他脚本占用（如 tail -f），会导致写入失败但无提示
实际分流逻辑越简单越可靠，重点不是“全分类”，而是把那几个真正影响核心链路的异常稳稳捕获住。其他异常留给默认 stack 或 single 通道兜底，反而更易维护。
