EvolutionAPI与Chatwoot集成中的消息重复问题分析

问题背景

在EvolutionAPI 1.8.1版本与Chatwoot客服平台集成时，开发人员发现了一个消息重复处理的问题。当用户通过非Chatwoot平台(如直接通过即时通讯应用)发送消息时，系统会错误地将这些消息重复处理，导致聊天界面中出现重复消息。

技术细节分析

问题的核心在于消息来源识别机制失效。正常情况下，系统应该通过检查消息的source_id字段来判断消息来源。如果source_id以"WAID:"开头，则表示消息来自即时通讯应用而非Chatwoot平台，应该忽略这类消息以避免重复处理。

然而在实际运行中发现：

1. source_id字段有时会为null，导致来源检查失败
2. 原有的过滤逻辑依赖于source_id字段，当该字段为null时无法正确识别消息来源

临时解决方案

开发者采用了替代方案来解决这个问题：

1. 查询数据库中最近的10条消息记录
2. 比较新接收消息内容与历史记录
3. 如果发现内容重复，则忽略该消息

这种方案虽然有效，但存在一定局限性：

• 增加了数据库查询开销
• 仅比较最近10条消息，可能存在漏判
• 内容完全相同的合法消息可能被错误过滤

根本原因推测

根据技术分析，source_id字段为null可能有以下原因：

1. Chatwoot平台API在某些情况下未正确设置该字段
2. 消息传输过程中字段丢失
3. EvolutionAPI与Chatwoot版本兼容性问题

项目维护者回应

项目维护团队表示1.8.1版本已不再接收更新，建议用户关注v2版本，该问题将在新版本中得到彻底解决。对于急需解决方案的用户，建议通过官方社区论坛寻求帮助。

给开发者的建议

对于仍在使用1.8.1版本的开发者：

1. 可以考虑实现更健壮的消息去重机制
2. 增加对source_id为null情况的处理
3. 考虑升级到v2版本以获得更好的兼容性

对于计划升级到v2版本的开发者：

1. 关注官方更新日志中关于Chatwoot集成的改进
2. 提前测试新版本的消息处理逻辑
3. 准备迁移方案以确保平滑过渡