JavaMail生成带长附件名的EML文件在Outlook中显示异常求助

问题背景 #

使用JavaMail/JakartaMail API（1.6.x版本）生成RFC格式的.eml文件时，当附件名称过长，JavaMail会遵循RFC2231第3节的参数值分段规则拆分文件名（观察下来约60字符后触发拆分）。

短附件名对应的Content-Disposition格式：

Content-Disposition: attachment;
    filename=short-filename.txt

长附件名被拆分后的格式：

Content-Disposition: attachment;
    filename*0=this-is-a-filename-with-more-than-60-characters-which-is-ult;
    filename*1=imately-the-source-of-this-question.txt

实际测试中，短附件名在Outlook中可正常显示，但长附件名会被显示为类似“unknown attachment 00004.txt”的名称；而在Mozilla Thunderbird中打开则无任何问题。

疑问与解答 #

核心疑问解析 #

这是Outlook的兼容性问题：Outlook对RFC2231的参数值分段规则支持不完善，并非JavaMail的实现错误。JavaMail是严格遵循RFC2231规范生成的邮件内容，而Thunderbird对邮件标准的兼容性覆盖更全面，因此能正常解析。

无需自行实现邮件生成的解决方案 #

• 禁用长参数分段，改用RFC2047编码：通过设置JavaMail的系统属性，强制其将长文件名用RFC2047编码为单一的filename参数，Outlook可正确识别。代码中添加如下配置即可：

  System.setProperty("mail.mime.splitlongparameters", "false");
  

  也可以在项目的配置文件中添加该属性，无需修改业务代码。

• 兼容双参数写法（可选）：手动为附件同时设置filename（RFC2047编码）和filename*（RFC2231格式），兼顾Outlook和其他标准兼容客户端，但这种方式需要额外处理文件名编码，不如第一种方法简便。

• 临时截断文件名（应急方案）：提前将附件文件名截断到60字符以内，避免触发JavaMail的分段逻辑，但这种方法会丢失部分文件名信息，仅适合临时应急场景。

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