EvolutionAPI中群组消息撤回功能的问题分析与解决方案

问题背景

在EvolutionAPI项目使用过程中，开发者发现了一个关于群组消息撤回功能的异常情况。具体表现为当调用/chat/deleteMessageForEveryone接口尝试撤回群组消息时，虽然API返回了看似成功的响应，但实际上消息并未被成功撤回。

问题现象

开发者通过API发送请求尝试撤回群组消息时，请求参数中指定了群组ID（以@g.us结尾）和消息ID。API返回的响应包含以下信息：

{
    "key": {
        "remoteJid": "[e-mail]",
        "fromMe": true,
        "id": "xxxxxxxxxxxx"
    },
    "message": {
        "protocolMessage": {
            "key": {
                "remoteJid": "[e-mail]",
                "fromMe": false,
                "id": "xxxxxxxxxxxxxxxx"
            },
            "type": "REVOKE"
        }
    },
    "messageTimestamp": "1723824184",
    "status": "PENDING",
    "participant": "´phonenumberFromBot:[e-mail]"
}

尽管响应显示撤回操作状态为"PENDING"且包含REVOKE类型，但实际群组中的消息并未被删除。开发者尝试了两种不同的群组ID格式（@g.us和@s.example.net），但问题依然存在。

技术分析

1. 版本因素：问题最初出现在EvolutionAPI v2.0.5-rc版本中。后续测试发现，在2.1.0版本中该功能曾经正常工作，但后来停止工作。

2. 缓存配置：有开发者建议启用本地缓存配置（设置CACHE_LOCAL_ENABLED=true）可能解决部分相关问题，但实际测试表明这可能引入其他问题，如消息发送失败。

3. 错误类型：在某些情况下，系统会抛出500错误，提示"TypeError: Cannot read properties of undefined (reading 'updateGroupMetadataCache')"，这表明在尝试更新群组元数据缓存时出现了问题。

解决方案

1. 版本升级：将EvolutionAPI升级到2.1.2或更高版本可以解决消息撤回功能失效的问题。多位开发者确认在升级后功能恢复正常。

2. 配置调整：虽然启用本地缓存(CACHE_LOCAL_ENABLED=true)曾被建议作为解决方案，但实际测试表明这可能影响消息发送功能，因此不建议作为首选方案。

3. 新版本问题：需要注意的是，升级到2.1.2版本后，部分开发者报告出现了历史版本中存在的"空白消息"问题，即系统会随机发送空内容消息到群组中。这可能需要额外的修复措施。

最佳实践建议

1. 定期检查并升级到EvolutionAPI的最新稳定版本，以确保获得最佳的功能支持和错误修复。

2. 在实现消息撤回功能时，建议：

   • 使用正确的群组ID格式（@g.us）
   • 确保API版本兼容性
   • 实现适当的错误处理和重试机制

3. 对于生产环境，建议在升级前进行全面测试，特别是检查消息撤回和发送功能的稳定性。

通过以上分析和解决方案，开发者可以更好地理解和解决EvolutionAPI中群组消息撤回功能的相关问题，确保应用功能的稳定性和可靠性。