Laravel怎么处理队列任务执行失败告警_Laravel集成企业微信通知【详解】-Laravel-PHP中文网

队列任务失败后需监听JobFailed事件并触发企业微信通知，通过异步任务发送带签名的HTTPS请求，配置敏感信息于.env和config/services.php中，并在最后一次重试失败时去重告警且记录日志。

laravel怎么处理队列任务执行失败告警_laravel集成企业微信通知【详解】

Laravel 默认只把失败任务写进 failed_jobs 表，不发通知。要告警，得自己钩住失败时机——最稳的方式是监听 Illuminate\Queue\Events\JobFailed 事件。

在 App\Providers\EventServiceProvider 的 $listen 数组里加：
Illuminate\Queue\Events\JobFailed::class => [App\Listeners\NotifyJobFailure::class]
用 php artisan make:listener NotifyJobFailure --event=JobFailed 生成监听器
别在监听器里直接调企业微信 API；先封装成可重试的异步通知任务（比如叫 SendWeComAlert），避免阻塞队列主流程

硬编码或写死在配置里等于裸奔。Laravel 的 .env + config/services.php 是标准解法，但要注意加载顺序和缓存影响。

在 .env 中加：
WECOM_WEBHOOK_TOKEN=xxx
WECOM_WEBHOOK_SECRET=yyy
在 config/services.php 里声明：
'wecom' => ['webhook_token' => env('WECOM_WEBHOOK_TOKEN'), 'webhook_secret' => env('WECOM_WEBHOOK_SECRET')]
运行 php artisan config:clear 后再测试，否则 config('services.wecom') 可能读不到新值

企业微信机器人要求 POST 请求带时间戳+签名，漏掉任意一项都会返回 40068 invalid signature 或 40013 invalid appid 类错误。

微信公众号发文助手

微信公众号产业研究发文助手，支持原文读取、分层摘要、产业链标的梳理、image2 海报与封面生成、正文排版、微信草稿保存、回读校验和发布前确认。

下载

签名生成必须用 HMAC-SHA256，且原文是 timestamp\nsecret（注意换行符是 \n，不是 \r\n）
URL 拼接格式为：
https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key={token}&timestamp={ts}&sign={encoded_sign}
用 GuzzleHttp\Client 发请求时，确保 json 参数传的是数组，不是 JSON 字符串；否则会报 invalid json

一个任务重试 3 次失败才真正“死亡”，但你不想每次失败都发一条消息——容易刷屏，也掩盖真正的问题点。

在监听器里通过 $event->job->attempts() 判断当前是第几次失败
只在最后一次失败（即 $event->job->attempts() >= $event->job->maxTries()）时触发通知
如果用了 redis 队列，还可加个简单去重：用 Cache::lock("alert:{$event->job->uuid()}", 300)->get(...) 防止并发重复发

企业微信通知本身不保证送达，签名、网络、token 过期、群聊被删……每个环节都可能静默失败。建议在通知逻辑里补一层日志记录（含响应 body），否则故障时连“到底发没发出去”都难确认。