一次企业微信回调丢失的排查记录

前几天在调企业微信客户事件时后台偶尔收不到回调。最开始怀疑是企业微信接口不稳定但同一时间其他事件又能正常进来问题明显不在平台本身。继续查日志后发现请求已经到达Nginx只是PHP没有留下业务记录。我先检查了回调地址、Token和EncodingAESKey配置都没问题。随后把原始请求体、请求头和解密结果分别写入临时日志才发现部分请求在读取php://input后又被后面的公共方法读取了一次。第二次拿到的内容为空验签自然失败但原来的代码只返回了一个统一错误没有记录具体原因。修复时没有直接改业务逻辑而是把原始请求体在入口处读取一次保存到变量再传给验签、解密和事件解析模块。与此同时把回调处理拆成“接收、验签、解密、去重、入库”几个步骤每一步都记录状态和耗时。重复事件则根据事件ID和企业微信用户标识做唯一判断避免平台重试时重复写入。这次排查让我更确定第三方回调最怕的不是报错而是错误信息太模糊。只要入口日志、原始报文和处理步骤能对上很多看似随机的问题其实都能很快定位。#企业微信开发 #PHP接口 #回调排查 #后端开发