Outlook与Hotmail中一键退订邮件头格式异常问题咨询

我用SendGrid 9.24.3的SendEmailAsync方法发邮件时遇到了以下问题：

• Gmail中邮件头和退订按钮显示完全正常
• Outlook/Hotmail里List-Unsubscribe头格式乱码，排查后确认是MIME自动格式化导致的——哪怕URI不含非ASCII字符、长度也符合标准，还是会被拆分成多行编码格式；同时添加mailto和URI两种退订方式时，只有URI部分会被自动格式化
• 另外发现Outlook仅支持通过mailto方式实现一键退订，URI方式不被识别，但其他厂商的邮件头在Outlook里却能正常显示

不同客户端的邮件头示例 #

Outlook中查看的邮件头：

List-Unsubscribe-Post: List-Unsubscribe=One-Click
List-Unsubscribe: mailto:example@example.dk,
=?us-ascii?Q?=3Chttps=3A=2F=2Fexampleservice=2Eemsp-tst=2Eexample=2Edk=2Fapi=2Fv1=2FExternalEma?=
=?us-ascii?Q?ilAdministration=2Funsubscribe=2F83e598f1-4?=
=?us-ascii?Q?4be-411c-a4ca-e922de65a5a7=2F10=3E?=

Gmail中查看的邮件头：

List-Unsubscribe-Post: List-Unsubscribe=One-Click
List-Unsubscribe: mailto:example@example.dk, https://exampleservice.emsp-tst.example.dk/api/v1/ExternalEmailAdministration/unsubscribe/83e598f1-44be-411c-a4ca-e922de65a5a7/10

解决步骤 #

1. 手动构造邮件头，避免自动MIME编码
   不要依赖SendGrid的默认处理逻辑，直接手动添加List-Unsubscribe和List-Unsubscribe-Post头，格式上用尖括号包裹mailto和URI，不要添加HTML标签（Outlook不识别这种格式），确保整行内容完整不拆分。示例格式：

List-Unsubscribe-Post: List-Unsubscribe=One-Click
List-Unsubscribe: <mailto:example@example.dk>, <https://exampleservice.emsp-tst.example.dk/api/v1/ExternalEmailAdministration/unsubscribe/83e598f1-44be-411c-a4ca-e922de65a5a7/10>

对应SendGrid代码实现：

var msg = new SendGridMessage();
msg.AddHeader("List-Unsubscribe-Post", "List-Unsubscribe=One-Click");
msg.AddHeader("List-Unsubscribe", "<mailto:example@example.dk>, <https://exampleservice.emsp-tst.example.dk/api/v1/ExternalEmailAdministration/unsubscribe/83e598f1-44be-411c-a4ca-e922de65a5a7/10>");

2. 适配Outlook的一键退订规则
   Outlook的一键退订功能仅识别未编码的mailto格式地址，所以必须保证List-Unsubscribe头里的mailto部分格式正确、未被编码。URI部分可以保留，虽然Outlook不会把它转为一键按钮，但Gmail等其他客户端仍能正常解析为退订按钮。

3. 验证最终邮件头
   发送测试邮件后，在Outlook中查看原始邮件头，确认List-Unsubscribe未被MIME编码拆分，保持完整的单行格式，即可确保Outlook识别mailto一键退订，同时其他客户端正常处理URI退订链接。

内容的提问来源于stack exchange，提问作者Bille