如何用base64编码数据发送内嵌图片？遇SMTP发送失败问题

核心问题分析 #

你遇到的三个问题本质上都是对JavaMail编码逻辑和SMTP协议规则的误解：

1. HTML内嵌Base64图片：Gmail等服务商为了安全和性能，会过滤这类直接内嵌的大Base64串
2. 普通MimeBodyPart放已编码Base64：JavaMail会自动对内容做Base64编码，相当于二次编码，直接破坏原始图片数据
3. PreencodedMimeBodyPart报错：未拆分的Base64串是超长单行，违反了SMTP协议每行不超过998字节的限制

正确实现步骤 #

最可靠的方式是让JavaMail自动处理编码和换行，核心是传入原始二进制图片数据，而非已编码的Base64字符串：

1. 使用multipart/related类型的多部分邮件，关联HTML正文和内嵌图片
2. HTML正文通过cid:引用图片的Content-ID
3. 图片部分传入原始字节数组，由JavaMail完成Base64编码和合规换行

代码示例

// 创建关联型多部分容器
MimeMultipart multipart = new MimeMultipart("related");

// 1. 添加HTML正文部分
MimeBodyPart htmlBody = new MimeBodyPart();
// HTML中用cid引用图片，注意Content-ID要和图片部分的对应
String htmlContent = "<html><body><p>这是内嵌图片：</p><img src='cid:embedded_image'></body></html>";
htmlBody.setContent(htmlContent, "text/html; charset=UTF-8");
multipart.addBodyPart(htmlBody);

// 2. 添加内嵌图片部分
MimeBodyPart imagePart = new MimeBodyPart();
// 将Base64字符串解码为原始二进制数据（如果你的源是Base64的话）
String base64ImageStr = "你的Base64图片编码字符串";
byte[] imageBytes = Base64.getDecoder().decode(base64ImageStr);

// 设置图片内容、类型和标头
imagePart.setContent(imageBytes, "image/jpeg"); // 根据图片类型调整MIME类型
imagePart.setHeader("Content-ID", "<embedded_image>"); // 与HTML中的cid一致
imagePart.setDisposition(MimeBodyPart.INLINE); // 标记为内嵌而非附件

multipart.addBodyPart(imagePart);

// 将多部分内容设置到邮件中
message.setContent(multipart);

备选方案（不推荐） #

如果一定要用PreencodedMimeBodyPart，需要手动给Base64字符串添加换行，每76个字符换行一次（符合Base64传输标准），确保单行长度不超过998字节：

// 手动拆分Base64字符串为合规行
String formattedBase64 = Base64.getMimeEncoder(76, "\r\n".getBytes()).encodeToString(imageBytes);
PreencodedMimeBodyPart imagePart = new PreencodedMimeBodyPart("base64");
imagePart.setContent(formattedBase64, "image/jpeg");
imagePart.setHeader("Content-ID", "<embedded_image>");
imagePart.setDisposition(MimeBodyPart.INLINE);

内容的提问来源于stack exchange，提问作者d'Laniger