Django Anymail中Mailjet后端对429响应的JSON解析问题解析

2025-07-08 00:21:25作者：傅爽业Veleda

问题背景

在使用Django Anymail库与Mailjet ESP集成时，开发人员发现当Mailjet返回429(Too Many Requests)状态码时，响应内容并非预期的JSON格式，而是一个简单的HTML页面。这导致了Anymail的JSON解析器抛出JSONDecodeError异常，进而影响了邮件发送流程的正常处理。

技术细节分析

Mailjet作为电子邮件服务提供商(ESP)，在API请求速率超过限制时会返回429状态码。按照REST API的最佳实践，这类错误响应通常应包含JSON格式的错误详情。然而，Mailjet在此情况下返回的是HTML内容：

<html><body><h1>429 Too Many Requests</h1></body></html>

Anymail库的Mailjet后端在处理响应时，默认假设所有4xx和5xx错误响应都包含JSON数据，直接尝试解析响应内容为JSON。这种假设在遇到HTML响应时就会失败，导致以下异常链：

首先触发Python内置的json.decoder.JSONDecodeError
然后被requests库捕获并重新包装为RequestsJSONDecodeError
最后被Anymail捕获并转化为AnymailRequestsAPIError

影响范围

这个问题会影响所有使用Anymail Mailjet后端的Django应用，当遇到API速率限制时，邮件发送功能会因解析错误而中断，而不是优雅地处理速率限制错误。

解决方案

官方修复方案

Anymail维护者已确认这是一个bug，并计划通过以下方式修复：

修改Mailjet后端的raise_for_status方法，在尝试解析JSON前检查响应内容类型
对于非JSON响应，调用父类方法处理，这将正确抛出包含原始响应内容的AnymailRequestsAPIError

临时解决方案

在官方修复发布前，开发者可以通过继承Mailjet后端并覆盖deserialize_json_response方法来实现临时解决方案：

from anymail.backends.mailjet import EmailBackend

class CustomMailjetEmailBackend(EmailBackend):
    def deserialize_json_response(self, response, payload, message):
        if response.status_code == 429:
            return {
                "ErrorCode": "429",
            }
        return super().deserialize_json_response(
            response=response, payload=payload, message=message
        )