Java发送Gmail：properties文件中Base64图片无法显示的解决方法

我之前处理过类似的Gmail邮件图片显示问题，你的情况是典型的邮件客户端对嵌入式base64图片的兼容限制导致的——Gmail（包括Outlook等主流客户端）对直接在HTML里写data:image格式的图片支持很差，大概率会被反垃圾机制拦截或者解析失败，所以才只渲染了宽高属性却显示占位框。

下面给你两种解决方案，优先推荐第一种（兼容性最好）：

方案1：使用CID内嵌附件（最可靠） #

这是邮件客户端通用的内嵌图片标准做法，把图片作为邮件的内嵌附件，然后在HTML里通过Content-ID（CID）引用它，步骤如下：

1. 用JavaMail API创建多部分MIME消息（MimeMultipart），区分HTML正文和图片附件
2. 给图片附件设置Content-ID和INLINE disposition（标记为内嵌而非普通附件）
3. 在HTML正文中用cid:xxx引用图片的Content-ID

示例代码：

// 初始化邮件消息（假设你已经配置好Session和Message对象）
MimeMessage message = new MimeMessage(session);

// 创建"related"类型的多部分消息，用于关联HTML和内嵌资源
MimeMultipart multipart = new MimeMultipart("related");

// 1. 添加HTML正文部分
BodyPart htmlBodyPart = new MimeBodyPart();
// 从properties读取的内容替换为cid引用，比如把原img标签改成 <img src="cid:employeeLogo">
String htmlContent = "Welcome {userfirstname} <br> <img src=\"cid:employeeLogo\" width=\"100px\" height=\"200px\">";
htmlBodyPart.setContent(htmlContent, "text/html; charset=UTF-8");
multipart.addBodyPart(htmlBodyPart);

// 2. 添加内嵌图片附件
BodyPart imageBodyPart = new MimeBodyPart();
// 读取图片文件（也可以从InputStream获取，比如你原本的base64解码成流）
DataSource imageSource = new FileDataSource("/path/to/your/image.jpg");
imageBodyPart.setDataHandler(new DataHandler(imageSource));
// 设置Content-ID，注意格式要带尖括号，自定义唯一标识即可
imageBodyPart.setHeader("Content-ID", "<employeeLogo>");
// 标记为内嵌附件，避免作为普通附件被单独显示
imageBodyPart.setDisposition(MimeBodyPart.INLINE);
multipart.addBodyPart(imageBodyPart);

// 把多部分内容设置为邮件的主体
message.setContent(multipart);

如果你的图片原本是base64字符串，可以先把它解码成ByteArrayInputStream，再用ByteArrayDataSource替代FileDataSource：

// 从properties读取base64字符串
String base64Image = properties.getProperty("new.emp.mail.reg.image.base64");
byte[] imageBytes = Base64.getDecoder().decode(base64Image);
DataSource imageSource = new ByteArrayDataSource(imageBytes, "image/jpeg");

方案2：修复base64方式（仅适合极小图片） #

如果你坚持要用base64，需要排查以下几个问题：

• 检查base64字符串完整性：properties文件中如果存在换行、空格或者特殊字符，可能会导致base64被截断。建议把base64内容单独放在一个文件中读取，或者在properties里用\换行（Java读取时会自动拼接）。
• 确保邮件Content-Type正确：必须把邮件内容设置为text/html，而不是text/plain——如果是纯文本模式，HTML标签根本不会被解析。
• 注意Gmail的大小限制：Gmail对data URI图片的大小限制很严格，超过几KB的图片会被直接屏蔽，仅适合极小的图标。

注意：即使修复了这些问题，base64方式依然存在兼容性问题，比如Outlook、苹果邮件客户端可能还是无法正常显示，所以优先推荐方案1。

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