javax.mail.BodyPart.getFileName返回null，换行引发的问题求解

这个问题我之前处理过类似的场景，本质是邮件头字段的**折叠（Folding）**导致JavaMail的默认解析逻辑没正确识别到filename参数——RFC 5322规定邮件头超过80字符时可以换行折叠，但部分JavaMail版本对带参数的Content-Type折叠处理存在缺陷，尤其是当filename参数被拆到下一行时，bodyPart.getFileName()就会返回null。

下面给你几个亲测有效的解决方案：

1. 手动解析完整的Content-Type头 #

绕过getFileName()，自己拼接折叠的头字段并解析参数，这是最稳妥的兼容方案：

import javax.mail.internet.ParameterList;
import javax.mail.internet.MimeUtility;

// 获取所有Content-Type头片段（处理折叠的多行）
String[] contentTypeHeaders = bodyPart.getHeader("Content-Type");
if (contentTypeHeaders != null && contentTypeHeaders.length > 0) {
    // 拼接所有折叠部分，去掉换行和多余空格
    StringBuilder fullContentType = new StringBuilder();
    for (String headerSegment : contentTypeHeaders) {
        fullContentType.append(headerSegment.trim());
    }
    
    // 拆分类型和参数部分
    String[] typeAndParams = fullContentType.toString().split(";", 2);
    if (typeAndParams.length > 1) {
        // 用JavaMail自带的ParameterList解析参数
        ParameterList params = new ParameterList(typeAndParams[1]);
        String fileName = params.get("filename");
        
        // 处理编码后的文件名（比如UTF-8 quoted-printable编码）
        if (fileName != null) {
            fileName = MimeUtility.decodeText(fileName);
            System.out.println("解析到文件名：" + fileName);
        }
    }
}

2. 升级JavaMail版本 #

JavaMail在1.6.2及以上版本修复了折叠头字段的解析问题，如果你用的是旧版本，直接升级依赖就能解决：
如果是Maven项目，修改依赖：

<dependency>
    <groupId>com.sun.mail</groupId>
    <artifactId>javax.mail</artifactId>
    <version>1.6.2</version>
</dependency>

Gradle项目则修改：

implementation 'com.sun.mail:javax.mail:1.6.2'

升级后再调用bodyPart.getFileName()应该就能正常识别折叠后的filename参数了。

补充说明 #

你提到手动把文件名移到同一行就正常，是因为JavaMail默认解析时，没有正确将折叠的行合并成完整的Content-Type字符串，导致filename参数被遗漏。上面两种方案要么手动合并解析，要么用修复后的版本处理，都能解决这个问题。

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