收发日志
收发日志记录机器人收到的消息和发出的回复,是排查“为什么没反应”的第一入口。
日志字段
| 字段 | 说明 |
|---|---|
| 时间 | 消息发生时间 |
| 机器人 | 哪个机器人 |
| 方向 | 收到 / 发出 |
| 场景 | 群聊 / 私聊 |
| 会话 | 群 openid 或用户 openid |
| 内容 | 文本或媒体占位 |
| 事件类型 | 群消息、@消息、成员事件等 |
排查流程
完全没收到消息
- 日志里没有入站记录
- 检查 QQ 开放平台事件订阅
- 检查 Webhook 地址是否可达
- 检查机器人是否被移出群
- 检查服务器防火墙/域名证书
收到消息但没有回复
- 日志有入站记录
- 检查机器人是否被禁言
- 检查插件开关
- 检查触发词是否精确匹配
- 检查是否超过被动回复 5 条上限
- 检查工作流/关键词是否短路
发出失败
看服务端日志中的错误码:
40034105:主动消息无权限/额度不足40093013:语音时长超限50035006:消息发送异常- 被动回复上限:同一条消息最多 5 条
日志保留
平台按自身策略保留日志;需要长期留存请定期导出或接入外部日志系统。
隐私
日志可能包含用户 openid、昵称、消息内容。不要公开分享含隐私的日志截图;排查时对 openid 打码。
