Django-Anymail新增功能：支持按收件人自定义邮件头(merge_headers)

在电子邮件发送场景中，经常需要为不同收件人定制特定的邮件头信息。例如，在批量发送营销邮件时，每个收件人的退订链接需要包含唯一的标识符。Django-Anymail作为Django的邮件后端库，最新版本中新增了merge_headers功能，完美解决了这一需求。

功能概述

merge_headers允许开发者为不同的收件人指定不同的邮件头信息，其使用方式与Anymail已有的merge_metadata和merge_data类似。以下是一个典型的使用示例：

message = AnymailMessage(
    to=["[e-mail]", "Bob <[e-mail]>"],
    headers={
        "List-Unsubscribe-Post": "List-Unsubscribe=One-Click",  # 所有收件人共有的头信息
    },
    merge_headers={
        "[e-mail]": {
            "List-Unsubscribe": "<https://example.com/unsubscribe/98765abc>",  # Alice专属
        },
        "[e-mail]": {
            "List-Unsubscribe": "<https://example.com/unsubscribe/12345xyz>",  # Bob专属
        },
    },
)

技术实现原理

该功能通过以下方式实现：

1. 核心数据结构：在AnymailMessage类中新增merge_headers属性，存储收件人邮箱与自定义头信息的映射关系
2. ESP适配层：为支持的邮件服务提供商(ESP)实现特定的参数转换逻辑
3. 合并策略：将公共headers与merge_headers中的收件人特定头信息合并，形成最终的发送参数

支持情况

目前该功能已支持以下邮件服务提供商：

• Amazon SES（仅限模板API）
• Brevo
• Mailgun（使用recipient-variables替换）
• Mailjet
• Postmark
• Resend
• SendGrid
• SparkPost（使用替换变量）
• Unisender Go（仅支持List-Unsubscribe头）

需要注意的是，MailerSend、Mandrill和Postal目前不支持此功能。

典型应用场景

1. 退订链接个性化：为每个用户生成唯一的退订链接
2. 跟踪标识：在邮件头中添加用户特定的跟踪ID
3. A/B测试：为不同用户组设置不同的邮件分类或优先级
4. 合规性需求：满足不同地区的数据保护法规要求

最佳实践建议

1. 优先使用标准化的邮件头字段，如List-Unsubscribe
2. 避免在邮件头中存储敏感信息
3. 对于大量收件人，考虑性能影响
4. 测试时验证各ESP对特定头字段的支持情况

这一功能的加入使得Django-Anymail在批量邮件发送场景下的灵活性得到了显著提升，特别是对于需要遵守电子邮件营销规范的应用来说，提供了更加便捷的解决方案。