如何在.eml文件预览器中正确显示HTML内联图片？

我之前开发EML预览工具时也碰到过一模一样的问题，核心原因是HTML里的cid:引用需要和内联附件的Content-ID关联，转成浏览器能直接识别的Data URL才能正常显示。下面是具体的解决步骤和代码示例：

核心思路 #

1. 解析EML时，同时提取HTML内容和所有内联附件（标记为inline的附件）；
2. 为每个内联附件建立「Content-ID → Base64 Data URL」的映射；
3. 将HTML中所有cid:xxx格式的图片src替换成对应的Data URL。

具体实现代码 #

结合你现有的代码，修改后的完整逻辑如下：

import org.springframework.mail.javamail.MimeMessageUtils;
import org.springframework.mail.javamail.MimeMessageParser;
import org.springframework.mail.javamail.Attachment;
import java.util.HashMap;
import java.util.Map;
import java.util.Base64;
import org.apache.commons.io.IOUtils; // 若没有该工具类，可自行实现流转字节数组的逻辑

// 原有的EML解析逻辑
MimeMessage mimeMessage = MimeMessageUtils.createMimeMessage(null, file);
MimeMessageParser parser = new MimeMessageParser(mimeMessage);
parser.parse();
String htmlBody = parser.getHtmlContent();

// 1. 构建CID到Data URL的映射表
Map<String, String> cidDataMap = new HashMap<>();
List<Attachment> attachments = parser.getAttachmentList();

for (Attachment attachment : attachments) {
    // 只处理内联附件（disposition为inline的附件）
    if (attachment.isInline()) {
        String contentId = attachment.getContentId();
        // 清理CID格式：很多邮件里的Content-ID会被<>包裹，需要去掉这些符号
        if (contentId != null) {
            contentId = contentId.replaceAll("^<|>$", "");
        }
        
        // 2. 将附件内容转为Base64编码的Data URL
        String contentType = attachment.getContentType();
        byte[] attachmentBytes = IOUtils.toByteArray(attachment.getInputStream());
        String base64Content = Base64.getEncoder().encodeToString(attachmentBytes);
        String dataUrl = String.format("data:%s;base64,%s", contentType, base64Content);
        
        cidDataMap.put(contentId, dataUrl);
    }
}

// 3. 替换HTML中的CID引用
for (Map.Entry<String, String> entry : cidDataMap.entrySet()) {
    String cid = entry.getKey();
    String dataUrl = entry.getValue();
    htmlBody = htmlBody.replace("cid:" + cid, dataUrl);
}

// 现在htmlBody中的图片已经可以直接在浏览器/HTML渲染组件中显示了

关键注意点 #

• CID格式处理：很多邮件生成的Content-ID会带有<>包裹（比如<0__=4EBB0EF7DFBA71E78f9e8a93df93869091@local>），必须去掉这些符号才能和HTML里的cid:0__=xxx匹配；
• 附件内容读取：如果你的Attachment类没有直接提供字节数组，可以通过getInputStream()读取流并转换为字节；
• Data URL兼容性：绝大多数现代浏览器都支持Data URL，足以满足预览场景的需求。

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