将含嵌入式图片的Multipart MimeMessage写入HTML文件遇问题求助

我之前处理邮件转HTML时也踩过这个坑——带内嵌图片的Multipart邮件直接转HTML会因为cid:引用无法被浏览器解析，导致图片显示不出来。下面是我验证过的两种可行方案，你可以根据需求选择：

方案一：将内嵌图片转为Base64直接嵌入HTML #

这种方式不需要额外保存图片文件，所有内容都打包在单个HTML里，适合单文件分发场景：

import javax.mail.*;
import javax.mail.internet.*;
import java.io.*;
import java.util.Base64;

public class MimeToHtmlConverter {
    public static void convert(MimeMessage mimeMsg, String htmlOutputPath) throws Exception {
        Multipart multipart = (Multipart) mimeMsg.getContent();
        StringBuilder htmlBuilder = new StringBuilder();

        // 遍历所有邮件部件
        for (int i = 0; i < multipart.getCount(); i++) {
            BodyPart part = multipart.getBodyPart(i);

            // 处理HTML文本部分
            if (part.isMimeType("text/html")) {
                htmlBuilder.append(part.getContent().toString());
            }
            // 处理纯文本部分（可选转HTML格式）
            else if (part.isMimeType("text/plain")) {
                String plainText = part.getContent().toString();
                htmlBuilder.append("<pre>").append(plainText).append("</pre>");
            }
            // 处理内嵌图片
            else if (part.isMimeType("image/*")) {
                // 提取Content-ID（去掉前后的<>）
                String cid = part.getHeader("Content-ID")[0].replace("<", "").replace(">", "");
                // 读取图片字节并转Base64
                InputStream imgStream = part.getInputStream();
                byte[] imgBytes = imgStream.readAllBytes();
                String base64Img = Base64.getEncoder().encodeToString(imgBytes);
                // 获取图片格式（如png/jpg）
                String imgType = part.getContentType().split("/")[1];
                
                // 替换HTML里的cid引用为base64数据URI
                htmlBuilder = new StringBuilder(
                    htmlBuilder.toString().replace("cid:" + cid, 
                    "data:image/" + imgType + ";base64," + base64Img)
                );
            }
        }

        // 写入HTML文件
        try (FileWriter writer = new FileWriter(htmlOutputPath)) {
            writer.write(htmlBuilder.toString());
        }
    }
}

方案二：保存内嵌图片到本地，修改HTML引用路径 #

如果邮件里的图片体积较大，Base64会让HTML文件过于臃肿，适合用这种方式拆分存储：

import javax.mail.*;
import javax.mail.internet.*;
import java.io.*;

public class MimeToHtmlWithLocalImages {
    public static void convert(MimeMessage mimeMsg, String htmlOutputPath, String imageSaveDir) throws Exception {
        // 创建图片存储目录
        File imgDir = new File(imageSaveDir);
        if (!imgDir.exists()) imgDir.mkdirs();

        Multipart multipart = (Multipart) mimeMsg.getContent();
        StringBuilder htmlBuilder = new StringBuilder();

        for (int i = 0; i < multipart.getCount(); i++) {
            BodyPart part = multipart.getBodyPart(i);

            if (part.isMimeType("text/html")) {
                htmlBuilder.append(part.getContent().toString());
            }
            else if (part.isMimeType("image/*")) {
                String cid = part.getHeader("Content-ID")[0].replace("<", "").replace(">", "");
                String imgFileName = cid + "." + part.getContentType().split("/")[1];
                String imgSavePath = imageSaveDir + File.separator + imgFileName;

                // 保存图片到本地
                try (OutputStream os = new FileOutputStream(imgSavePath)) {
                    part.getDataHandler().writeTo(os);
                }

                // 替换HTML里的cid引用为本地图片相对路径
                htmlBuilder = new StringBuilder(
                    htmlBuilder.toString().replace("cid:" + cid, imgFileName)
                );
            }
        }

        // 写入HTML文件
        try (FileWriter writer = new FileWriter(htmlOutputPath)) {
            writer.write(htmlBuilder.toString());
        }
    }
}

关键注意事项 #

• 递归处理嵌套Multipart：有些邮件会用嵌套的Multipart（比如multipart/alternative里包含multipart/related），需要把部件遍历逻辑改成递归，才能处理所有层级的内嵌资源
• Content-ID兼容：部分邮件的Content-ID可能没有用<>包裹，要提前做判断处理
• 顺序问题：建议先提取HTML文本，再处理图片替换，避免替换逻辑失效

举个递归处理嵌套Multipart的示例片段：

private static void processNestedMultipart(Multipart multipart, StringBuilder htmlBuilder, String imageDir) throws Exception {
    for (int i = 0; i < multipart.getCount(); i++) {
        BodyPart part = multipart.getBodyPart(i);
        if (part.getContent() instanceof Multipart) {
            // 递归处理子Multipart
            processNestedMultipart((Multipart) part.getContent(), htmlBuilder, imageDir);
        } else {
            // 这里处理文本和图片，逻辑和上面一致
        }
    }
}

这样应该就能解决你遇到的嵌入式图片无法显示的问题了，你可以根据实际场景选择合适的方案。

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