Laravel SlackLog_错误日志推送到Slack【教程】

Lara vel 9+ 集成 Slack 日志通道，理论上只需要改一行配置就能把错误消息推送到 Slack 频道——但实际踩坑的人不少。关键不在于代码，而在于三个硬性条件是否同时满足：LOG_CHANNEL 必须设为 slack，SLACK_WEBHOOK_URL 必须是一个完整的 HTTPS 地址，且触发的日志级别至少是 error。任何一个条件没到位，Lara vel 都不会报错，消息就这样静默消失了。

LOG_CHANNEL=slack 却没消息？先查这三件事

最常见的情况是，配置写对了但消息压根没发出去。问题往往出在前面三个条件之一，而且 Lara vel 不会告诉你哪里出错。具体排查方向如下：

• LOG_CHANNEL 的值是不是真的 slack，而不是 stack 或拼写错误。
• SLACK_WEBHOOK_URL 是否准确写在 .env 里，并且是完整的 HTTPS 链接（比如 https://hooks.slack.com/services/...），前面的 https:// 一定不能丢。
• 触发日志的代码用的是 error 还是更低级别？Slack 通道默认只响应 error 及以上，如果用 Log::warning('oops')，消息不会发出去。

想快速验证？直接进 php artisan tinker 执行一行 Log::channel('slack')->error('test from tinker');，比改业务代码快得多。

config/logging.php 里 slack 通道的 level 和 formatter 怎么调

Slack 通道默认只推 error 级别，如果连 warning 也想推，需要显式修改配置：

'slack' => [    'driver' => 'slack',    'url' => env('SLACK_WEBHOOK_URL'),    'username' => 'Lara vel Log',    'emoji' => ':boom:',    'level' => 'warning', // ← 把这里的 'error' 改成 'warning'],

如果还想带上请求上下文，比如当前用户的 IP、URL 或用户 ID，默认的 formatter 不会帮你干这件事。需要在 slack 配置里加上自定义 formatter：

'formatter' => \Monolog\Formatter\LineFormatter::class,'formatter_with_context' => true,

更进一步的话，需要自己写一个继承 LineFormatter 的类，重写 format() 方法，把 $record['context'] 里的字段填充到 Slack 消息体中——因为原生 Slack handler 不会自动解析 context 字段。

本地开发误推 Slack？用 stack + 环境判断更稳

很多人图省事直接 LOG_CHANNEL=slack 写在 .env 里，结果本地调试时不小心就推了一堆测试日志到生产 Slack 频道，相当尴尬。推荐做法是保持 LOG_CHANNEL=stack，然后在 config/logging.php 的 stack.channels 数组里动态控制：

• 定义一个专用通道，比如 'production_slack'，driver 为 slack。
• 在 stack.channels 里写：env('APP_ENV') === 'production' ? ['single', 'production_slack'] : ['single']

这样本地 APP_ENV=local 就完全不走 Slack，也省得反复改 .env。后续加 Sentry 或 DB 日志，只需往数组里追加 channel 名，不需要碰环境变量。

Webhook 失败不报错，curl 测试是唯一靠谱验证手段

Lara vel Slack 日志通道底层用的是 Monolog 的 SlackWebhookHandler，它有一个坏习惯：发送失败时直接忽略异常，既不抛出、不记录、也不提醒——你什么都看不到。

所以每次换了 Webhook URL 或者上线前，必须手动用 curl 测一遍：

curl -X POST \  -H 'Content-type: application/json' \  --data '{"text":"test from curl"}' \  https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXXXXXX

如果 curl 成功但 Lara vel 不发，问题一定出在配置或日志级别；如果 curl 都失败，说明 Webhook URL 无效、被公司防火墙拦截，或者 Slack 工作区已经禁用了 Incoming Webhooks。