迁移公司通讯至Mailgun：多列表发件避免同一收件人重复接收

Hey there! 针对你迁移Mailgun时遇到的跨列表发送重复收件人问题，结合Mailgun的特性和常见的邮件架构实践，这里有几个实用的解决方案，你可以根据自己的系统复杂度和迁移成本来选择：

1. 利用Mailgun原生合并列表功能（最简单的方案） #

• 操作逻辑：创建一个合并列表（Mailing List of Lists），把需要发送的所有主题子列表添加到这个合并列表中。发送邮件时直接指向这个合并列表，Mailgun会自动处理去重——同一收件人哪怕在多个子列表里，只会收到一份邮件。
• 优势：零开发成本，完全依赖Mailgun的内置能力，不需要改动现有列表结构。
• 注意事项：确保子列表都是Mailgun标准邮件列表，合并列表支持的嵌套层级建议控制在2层以内；另外合并列表的成员是动态同步的，子列表的增减会自动反映到合并列表中。

2. 自定义全局去重逻辑（可控性最高） #

• 操作逻辑：发送邮件前，先调用Mailgun API拉取所有目标主题列表的收件人邮箱，在你的系统里用Set（或类似的去重数据结构）对邮箱进行去重，得到唯一收件人集合后，再通过Mailgun的批量发送API直接发送给这个去重后的列表（或者临时创建一个一次性列表发送）。
• 优势：完全自定义去重规则，比如除了邮箱，还可以结合用户ID等维度去重，适合有特殊业务规则的场景。
• 注意事项：如果列表规模较大（比如10万+收件人），要考虑拉取和去重的性能；同时要注意Mailgun单次发送的收件人上限，必要时拆分批次发送。

3. 结合批量发送API实现去重（适合个性化发送场景） #

• 操作逻辑：使用Mailgun的批量发送功能，在提交发送任务时，将所有目标列表的收件人都导入，并给每个收件人带上唯一的用户标识（比如user_id）。部分版本的Mailgun批量发送支持基于邮箱自动去重，你也可以通过自定义变量配置去重规则，确保同一用户只收到一次邮件。
• 优势：既能实现去重，又能同时给不同收件人发送个性化内容（比如通过recipient-variables插入用户专属信息）。
• 注意事项：需要熟悉Mailgun批量发送的API参数，比如recipient-variables的格式，以及去重规则的配置细节，建议先在测试环境验证效果。

4. 用标签重构订阅体系（长期最优方案） #

• 操作逻辑：放弃为每个主题创建单独列表的模式，改为维护一个全局收件人列表，给每个用户的订阅主题打上对应的标签（比如topic:tech-updates、topic:weekly-news）。发送邮件时，通过Mailgun的标签筛选功能指定目标标签，Mailgun会返回符合条件的唯一收件人集合，自然避免重复。
• 优势：从根源上解决了重复订阅的问题，后续的订阅、退订、统计分析都会更简洁，也更符合Mailgun的最佳实践。
• 注意事项：需要调整现有订阅系统的逻辑，把“订阅主题=加入列表”改成“订阅主题=添加标签”，迁移成本相对较高，但长期维护成本低。

内容的提问来源于stack exchange，提问作者Janus Bahs Jacquet