附带ical邀请的HTML邮件在主流邮件客户端无法正常显示正文咨询

问题根源 #

你当前的MIME结构配置错误，使用了multipart/alternative作为最外层类型，该类型的定义是所有子部分为互斥等价的内容，邮件客户端只会选择自身支持的优先级最高的一个子部分展示，不会同时展示多个。
你把text/calendar和纯文本、HTML正文放在同一层级的multipart/alternative下，支持日历邀请的客户端就会直接选择展示ical内容，忽略前面的正文部分，这就是Thunderbird只显示邀请不显示正文的原因。Outlook 2013的解析逻辑特殊，在这种结构下会错误读取HTML内容但无法正确解析样式结构，才会出现样式丢失的问题。

修复方案 #

调整MIME嵌套结构，按照如下层级修改即可：

1. 最外层使用multipart/mixed类型，允许同时存在多个不同用途的子部分
2. 第一个子部分为multipart/alternative类型，内部仅包含text/plain和text/html两个正文子部分，供客户端选择展示
3. 第二个子部分单独放text/calendar日历邀请内容

修改后的邮件头核心结构示例：

Date: Thu, 26 Aug 2021 08:47:10 +0200 (CEST)
From: John Doe <john@doe.com>
To: Max Mustermann <max@mustermann.de>
Subject: =?UTF-8?Q?Best=C3=A4tigung_Ihres_Termins_am_18.08.2020?=
MIME-Version: 1.0
Content-Type: multipart/mixed; 
    boundary="----=_Part_Outer_123456789.1629960429000"

------=_Part_Outer_123456789.1629960429000
Content-Type: multipart/alternative; 
    boundary="----=_Part_Inner_987654321.1629960429000"

------=_Part_Inner_987654321.1629960429000
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: quoted-printable

<... 纯文本正文内容 ...>

------=_Part_Inner_987654321.1629960429000
Content-Type: text/html; charset=UTF-8
Content-Transfer-Encoding: quoted-printable

<!doctype html>
<... HTML正文内容 ...>

------=_Part_Inner_987654321.1629960429000--

------=_Part_Outer_123456789.1629960429000
Content-Type: text/calendar; charset=UTF-8; method=REQUEST
Content-Transfer-Encoding: 7bit
Content-Disposition: inline; filename="invite.ics"

BEGIN:VCALENDAR
<... ical邀请内容 ...>
END:VCALENDAR

------=_Part_Outer_123456789.1629960429000--

额外优化建议 #

• 给text/calendar部分加上Content-Disposition: inline; filename="invite.ics"属性，兼容更多客户端的邀请识别逻辑
• HTML邮件不要使用外部样式、头部样式，所有CSS都写为行内样式，进一步兼容Outlook的解析规则
• 检查ical的METHOD参数和邮件头method属性值保持一致，避免部分客户端识别邀请失败

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