Django-Anymail项目中Unisender Go的JSON转义问题解析

在Django-Anymail项目与Unisender Go ESP集成的过程中，开发人员发现了一个关于JSON序列化的兼容性问题。这个问题影响了特定类型的事件通知处理，特别是当事件数据中包含正斜杠("/")字符时。

问题现象

当使用Unisender Go作为电子邮件服务提供商时，系统会接收到各种事件通知的webhook回调。测试发现：

• SENT（发送）和DELIVERED（投递）事件能够正常处理
• OPENED（打开）和CLICKED（点击）事件会抛出AnymailWebhookValidationFailure异常

根本原因分析

经过深入调查，发现问题源于Unisender Go的JSON序列化实现与Python标准库的差异：

1. 转义行为不一致：Unisender Go在JSON序列化时对正斜杠("/")进行了不必要的转义，例如将URL转换为"https:\/\/example.com\/"的形式
2. 签名验证失败：Django-Anymail使用MD5哈希来验证webhook请求的完整性，由于转义差异导致计算出的哈希值不匹配
3. 影响范围：所有包含正斜杠的数据都会触发此问题，包括：
   • 点击事件中的URL
   • 开启了"附加投递信息"选项的打开事件中的用户代理字符串
   • 任何包含斜杠的自定义元数据

技术细节

在JSON规范中，正斜杠("/")虽然是可转义字符，但不是必须转义的。Python的json模块默认不转义正斜杠，而Unisender Go的实现选择了转义，这种差异导致了兼容性问题。

签名验证过程大致如下：

1. ESP发送带有签名的webhook请求
2. Django-Anymail接收后重新计算请求体哈希
3. 由于转义差异，本地计算的哈希与ESP提供的签名不匹配
4. 系统抛出AnymailWebhookValidationFailure异常

解决方案

该问题的修复方案主要涉及对接收到的JSON数据进行规范化处理，确保在计算哈希前将转义的正斜杠统一为标准形式。具体实现包括：

1. 在验证签名前对请求体进行预处理
2. 将Unisender Go特有的转义序列转换为标准JSON格式
3. 保持与Python json模块一致的序列化行为

最佳实践建议

对于使用Django-Anymail与各类ESP集成的开发者，建议：

1. 全面测试所有类型的事件回调
2. 特别注意包含特殊字符的数据字段
3. 了解不同ESP在JSON序列化上的潜在差异
4. 及时更新到包含此修复的Anymail版本

这个问题不仅揭示了不同JSON实现间的微妙差异，也提醒我们在处理webhook集成时需要更加细致地考虑数据格式的兼容性问题。通过这次修复，Django-Anymail对Unisender Go的支持将更加稳定可靠。