使用JavaMail API 1.4通过IMAP读取邮件时message.getDescription()返回null

嘿，咱们来搞定这个问题！首先得澄清一个很容易踩的误区——你可能误以为message.getDescription()能获取邮件正文或内容预览，但它的真实用途完全不是这个哦。

为什么会返回null？ #

这个方法对应的是MIME邮件里的Content-Description头字段，它的作用是描述邮件的某个MIME部分（比如附件），而非用来获取邮件正文或摘要。绝大多数普通邮件（纯文本、HTML邮件）根本不会设置这个字段，所以返回null是完全正常的情况。

你可以用这段代码验证邮件是否真的存在这个头字段：

String[] descHeaders = message.getHeader("Content-Description");
if (descHeaders == null) {
    System.out.println("当前邮件未设置Content-Description字段");
} else {
    for (String header : descHeaders) {
        System.out.println("Content-Description内容：" + header);
    }
}

如果你想获取邮件正文/预览该怎么做？ #

如果你的真实需求是获取邮件内容或预览摘要，得换用对应的API，针对JavaMail 1.4版本，给你两种常见场景的解决方案：

1. 获取纯文本正文

邮件可能是单部分（纯文本）或多部分（带附件、HTML+纯文本混合），需要分别处理：

try {
    Object content = message.getContent();
    if (content instanceof String) {
        // 单部分纯文本邮件直接获取内容
        String plainText = (String) content;
        System.out.println("邮件正文：" + plainText);
    } else if (content instanceof Multipart) {
        // 多部分邮件，遍历找到纯文本部分
        Multipart multipart = (Multipart) content;
        for (int i = 0; i < multipart.getCount(); i++) {
            BodyPart bodyPart = multipart.getBodyPart(i);
            if (bodyPart.isMimeType("text/plain")) {
                String plainText = (String) bodyPart.getContent();
                System.out.println("纯文本正文：" + plainText);
                break; // 取第一个纯文本部分即可
            }
        }
    }
} catch (Exception e) {
    e.printStackTrace();
}

2. 获取邮件预览摘要

邮件预览没有标准的字段定义，你可以尝试两种方式：

• 检查非标准自定义头：比如X-Preview、X-Keywords这类字段，但不是所有邮件都会提供；
• 自行截取正文：从纯文本正文中截取前N个字符（比如200个）作为预览，这种方式兼容性更强。

额外提醒 #

JavaMail 1.4是比较老旧的版本了，后续版本（如1.6.x）修复了不少bug，API也更完善。如果条件允许，建议升级到最新稳定版，能避免不少兼容性问题。

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