Spring Boot邮件服务发送的图片在Gmail中无法显示问题

针对你遇到的本地正常但Gmail无法显示内嵌Logo的问题，给你几个针对性的解决方案：

1. 修复资源读取逻辑（最可能的根因） #

本地IDE运行时，getResource().getFile()能正常读取资源，但项目打包成Jar后，Jar内的资源并非文件系统中的真实文件，会导致读取的字节数组异常，Gmail无法解析。替换成流读取方式：

修改EmailService.java中读取Logo的代码：

// 替换原来的byte[] logoBytes = Files.toByteArray(logoResource.getFile());
byte[] logoBytes;
try (InputStream is = logoResource.getInputStream()) {
    logoBytes = org.apache.commons.io.IOUtils.toByteArray(is);
}

如果不想引入Apache Commons IO，也可以自己实现流转字节数组：

byte[] logoBytes;
try (InputStream is = logoResource.getInputStream();
     ByteArrayOutputStream baos = new ByteArrayOutputStream()) {
    byte[] buffer = new byte[1024];
    int len;
    while ((len = is.read(buffer)) != -1) {
        baos.write(buffer, 0, len);
    }
    logoBytes = baos.toByteArray();
}

2. 简化MIME图片部分的头信息设置 #

代码中重复设置Content-Type头可能导致Gmail解析冲突，去掉冗余的头设置：

修改EmailConfiguration.java中imagePart的代码，删除这一行：

// 移除该行，避免重复设置Content-Type
imagePart.setHeader("Content-Type", contentType + "; name=logo.png");

3. 调整MIME部件的添加顺序 #

尝试将图片部件先添加到Multipart中，再添加HTML部件，部分邮件客户端对顺序敏感：

MimeMultipart multipart = new MimeMultipart("related");
// 先加图片部件
multipart.addBodyPart(imagePart);
// 再加HTML部件
multipart.addBodyPart(htmlPart);
message.setContent(multipart);

4. 检查Gmail的图片显示设置 #

确认你的Gmail账户是否开启了"始终显示外部图片"：

• 打开Gmail设置 -> 常规 -> 图片 -> 选择"始终显示外部图片"

5. 验证邮件原始结构 #

发送测试邮件后，在Gmail中打开邮件，点击右上角"更多" -> "显示原始邮件"，检查以下内容：

• 图片部件的Content-ID是否为<logo>
• Content-Disposition是否为inline
• Content-Type是否为image/png; name=logo.png

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