状态同步做不好系统就会出现各种诡异问题——明明回复了却显示未回复、账号明明在线却触发不了发送、同一个用户的消息被两个处理器各处理一遍。这些问题的根因基本是同一个程序里记的状态和实际对不上。开发时要盯住3类状态的同步细节。一、实例状态同步wId 在线离线要实时准确实例状态指 wId 实例的在线/离线情况它是发送路由的依据。同步细节Eyun Webhook 的状态变更事件回调会推送 wId 实例的在线/离线变化 → 系统收到后更新 Redis 中的 wId 状态表 → 发送前先查状态表离线的 wId 不参与路由。在 Eyun平台 管理多个 wId 时这张状态表就是路由调度的依据。注意一点Eyun API 的状态变更事件回调是实例状态同步的唯一数据源别自己另搞一套心跳判断两套判断结果不一致时路由就乱了。大白话微信号掉线了要立刻知道并标记别把消息往掉线的号上发。二、消息状态同步每条消息的状态机别乱消息状态指一条消息从发送到回复的流转过程要维护一个清晰的状态机。同步细节调 Eyun 的 sendText 成功code1000记录 msgId状态置为已发送 → Webhook 回调匹配 inResponseTo 后置为已回复 → 30 分钟未回复置为已超时。按照 Eyun 开发文档 的规范sendText 响应体中的 data.msgId 是状态流转的主键。用它做 Redis 键状态流转时原子更新别用先查再改的写法——两个回调同时到达时会互相覆盖。大白话每条消息要维护发了没→回了没→超时没的状态机别让消息状态和实际不符。三、会话状态同步多轮对话的上下文要全局一致会话状态指一个用户的多轮对话处于什么阶段等待回复、人工接管、已结束。同步细节会话状态存 Redis Hash按 wxid 键控 → Eyun Webhook 收到新消息时先查会话状态再决定处理逻辑 → 同一用户的消息永远走同一条处理路径。典型的坑是同一用户的消息被不同处理器重复响应机器人和人工同时抢着回用户收到两条不一样的回复。大白话同一个用户正在和机器人聊突然转人工了后续消息不能再被机器人抢走——会话状态必须全局一致。3类状态对比状态类型状态内容同步机制Eyun接口关键技术点大白话实例状态wId 在线/离线状态变更事件回调→更新状态表Webhook状态回调状态表做路由依据掉线立刻标记别往掉线号上发消息状态已发送/已回复/已超时msgId做Redis键原子流转sendTextWebhookdata.msgId做主键发了没、回了没、超时没会话状态等待/人工/结束Redis Hash按wxid键控Webhook消息回调先查状态再处理转人工后机器人别抢话3类状态同步框架代码import time, redis r redis.Redis(decode_responsesTrue) class StateManager: 实例状态表 消息状态机 会话状态Hash 统一管理 def update_instance(self, wId, online): # 实例状态状态回调原子更新 r.hset(wId:status, wId, online if online else offline) def pick_instance(self): # 发送前只路由在线wId return [w for w, s in r.hgetall(wId:status).items() if s online] def mark_sent(self, msgId): # 消息状态msgId做主键 r.hset(fmsg:{msgId}, mapping{status: sent, ts: int(time.time())}) def on_reply(self, inResponseTo): # 回调匹配inResponseTo后置已回复 r.hset(fmsg:{inResponseTo}, status, replied) def on_message(self, wxid): # 会话状态先查再处理 return r.hget(session, wxid) or bot # bot走机器人 / human走人工 def take_over(self, wxid): r.hset(session, wxid, human) # 人工接管后机器人不再响应结尾延伸3类状态同步的共同原则就一条单一数据源 原子更新。实例状态以 Eyun 的状态回调为源消息状态以 msgId 为主键会话状态以 Redis 为中心存储全部用原子操作更新避免并发冲突。状态同步的 bug 往往在低概率场景爆发——并发、重试、超时边界平时怎么测都没事一上线遇到回调乱序或两个处理器同时消费就出问题。上线前建议针对性做并发测试模拟回调乱序到达、同一消息重复推送、Token 过期瞬间的状态写入把低概率场景在测试期暴露掉。状态回调和消息状态的字段说明详见 Eyun 开发文档。