机器人看起来是自动聊天拆开看是三层架构。每一层职责清晰、边界明确理解了分层开发时就知道问题出在哪一层。一、通道层——解决程序怎么连上微信最底层是通道程序和微信之间怎么通信。这一层包括 HTTP 请求通道调接口发指令、Webhook 回调通道微信事件推给程序、鉴权机制Token 证明身份、wId 标识实例。通道层的核心指标是可靠请求能不能到、回调会不会丢、掉线能不能感知。错误码体系1000 成功、1002 Token 过期、1004 限频和回调重试机制5 秒超时、3 次重试都在保障这一层。开发者大部分时候不用自己实现通道但必须懂它的规则——回调 5 秒必须响应这决定了上层必须异步处理。二、能力层——解决程序能对微信做什么中间层是能力接口发文本、发图片、管好友、管群、查记录。每个接口是一个原子能力参数和返回都有明确契约。能力层是工具货架。机器人的功能不是写死的而是从货架上选能力组合出来的。需要客服就选消息回调 sendText需要群运营就再加群事件 群管理接口。三、应用层——解决程序拿能力做什么最上层是业务逻辑收到消息怎么判断、命中什么规则、调哪个业务系统、回复什么内容。这一层完全由开发者写接口服务不干涉。三层的关系是应用层编排能力层能力层走通道层。问题排查也按层来——消息没收到查通道层回调通不通收了没动查应用层逻辑对不对动了发不出查能力层参数错没错。三层架构对照架构层职责关键机制出问题的现象通道层程序连微信HTTP/Webhook/Token/wId收不到消息、接口不通能力层原子操作接口sendText/群管/好友接口能收不能发、参数报错应用层业务逻辑规则、状态、系统对接能收不回、回复错误三层协作示例# 通道层Webhook 接收 app.post(/webhook) def webhook(): d request.json queue.put(d) # 5秒内响应处理丢给队列 return {code: 1000} # 能力层封装原子接口 def send(to, text): return requests.post(f{BASE}/sendText, headersH, json{wId: WID, toUser: to, content: text}) # 应用层业务编排 def worker(): while True: msg queue.get() if 退款 in msg[content]: order refund_system.query(msg[fromUser]) # 调业务系统 send(msg[fromUser], f你的退款进度{order})落地建议开发时按层隔离代码通道层只做收发和鉴权能力层封装成函数库应用层写业务。混在一起写的代码初期快后期乱分层清晰的代码换接口服务、加业务功能都不痛苦。接口规范参考 Eyun 开发文档。