Webhook 用来接收业务事件时最怕的不是接口报错而是消息没有被完整处理系统却没有发现。如果发现企业微信消息偶尔没有进入业务系统可以先检查下面几个地方。1. 回调接口有没有及时响应不要在接收回调时直接执行耗时操作比如查询多个数据库、调用 AI 或连续请求其他接口。更稳妥的做法是先校验数据再将任务可靠地写入队列之后快速返回。注意不能在消息尚未可靠保存时就直接确认接收成功否则进程异常时仍可能丢失任务。2. 队列里的消息有没有积压如果回调接收正常但业务处理越来越慢就要检查队列长度、任务等待时间和消费者运行状态。建议监控以下指标待处理任务数量最老任务的等待时间任务处理成功率失败任务和重试次数如果队列持续增长说明消息进入速度超过了处理速度需要增加消费者或优化业务逻辑。3. 异常任务有没有被记录不要捕获异常后直接忽略也不要只打印一句“处理失败”。至少记录任务ID、接收时间、错误原因和重试次数。对于临时错误可以按策略重试对于参数错误等不可恢复的问题则应进入失败队列等待排查。4. 如何确认消息真的丢了排查时可以对比三个位置的数据回调接收日志、队列任务记录、业务处理结果。这样可以判断问题发生在接收、入队还是消费阶段。另外Webhook 的重试机制和超时规则取决于具体平台不能默认所有回调都会自动重发。对于重要业务应该设计消息持久化、幂等处理和失败补偿机制。核心原则接收成功不等于处理完成处理失败也不能没有记录。 企业微信Webhook回调丢消息？这几个地方要重点检查
Webhook 用来接收业务事件时最怕的不是接口报错而是消息没有被完整处理系统却没有发现。如果发现企业微信消息偶尔没有进入业务系统可以先检查下面几个地方。1. 回调接口有没有及时响应不要在接收回调时直接执行耗时操作比如查询多个数据库、调用 AI 或连续请求其他接口。更稳妥的做法是先校验数据再将任务可靠地写入队列之后快速返回。注意不能在消息尚未可靠保存时就直接确认接收成功否则进程异常时仍可能丢失任务。2. 队列里的消息有没有积压如果回调接收正常但业务处理越来越慢就要检查队列长度、任务等待时间和消费者运行状态。建议监控以下指标待处理任务数量最老任务的等待时间任务处理成功率失败任务和重试次数如果队列持续增长说明消息进入速度超过了处理速度需要增加消费者或优化业务逻辑。3. 异常任务有没有被记录不要捕获异常后直接忽略也不要只打印一句“处理失败”。至少记录任务ID、接收时间、错误原因和重试次数。对于临时错误可以按策略重试对于参数错误等不可恢复的问题则应进入失败队列等待排查。4. 如何确认消息真的丢了排查时可以对比三个位置的数据回调接收日志、队列任务记录、业务处理结果。这样可以判断问题发生在接收、入队还是消费阶段。另外Webhook 的重试机制和超时规则取决于具体平台不能默认所有回调都会自动重发。对于重要业务应该设计消息持久化、幂等处理和失败补偿机制。核心原则接收成功不等于处理完成处理失败也不能没有记录。 RELATED READING
延伸阅读
更多一线实战笔记与深度复盘，助您持续精进
