本文介绍如何在Java中动态生成二维码，并通过MIME CID机制将其直接嵌入HTML邮件模板的标签中，避免临时文件写入磁盘，提升安全性与性能。
本文介绍如何在java中动态生成二维码，并通过mime cid机制将其直接嵌入html邮件模板的``标签中，避免临时文件写入磁盘，提升安全性与性能。
在实际企业级邮件通知场景（如订单确认、两步验证、电子票券）中，常需将动态生成的二维码直接嵌入HTML邮件正文。若按传统方式先写入PNG文件再读取附件，不仅引入I/O开销和临时文件清理风险，还可能因并发导致文件名冲突或权限问题。理想方案是内存直传：将二维码图像数据以字节数组形式编码为内联资源，并通过cid:（Content-ID）URI在HTML中引用。
核心实现步骤
-
生成二维码并转为字节数组
使用ZXing库生成BitMatrix后，不写入文件，而是用ByteArrayOutputStream捕获PNG字节流：
import com.google.zxing.BarcodeFormat;
import com.google.zxing.WriterException;
import com.google.zxing.common.BitMatrix;
import com.google.zxing.qrcode.QRCodeWriter;
import com.google.zxing.client.j2se.MatrixToImageWriter;
import javax.imageio.ImageIO;
import java.awt.image.BufferedImage;
import java.io.ByteArrayOutputStream;
import java.io.IOException;
public byte[] generateQrCodeBytes(String content) throws WriterException, IOException {
QRCodeWriter writer = new QRCodeWriter();
BitMatrix matrix = writer.encode(content, BarcodeFormat.QR_CODE, 450, 450);
BufferedImage image = MatrixToImageWriter.toBufferedImage(matrix);
ByteArrayOutputStream baos = new ByteArrayOutputStream();
ImageIO.write(image, "PNG", baos);
return baos.toByteArray();
}
-
构建带CID引用的HTML模板
在邮件HTML中使用，其中cid值需与后续添加的MIME附件ID严格一致：
<h2>您的验证码</h2>
<p>请扫描下方二维码完成验证：</p>
@@##@@
<p>内容：{content}</p><div class="aritcle_card flexRow artxards">
<div class="artcardd flexRow">
<a class="aritcle_card_img" rel="nofollow" href="/xiazai/skill9469" title="java后端编程"><img
src="https://img.php.cn/upload/skill/000/000/081/179263995623864.jpg" alt="java后端编程" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
<div class="aritcle_card_info flexColumn">
<a rel="nofollow" href="/xiazai/skill9469" title="java后端编程" class="overflowclass">java后端编程</a>
<p class="overflowclass">专用于 Java Spring Boot 后端开发的专业技能。当用户提出以下需求时，应调用此技能：构建 REST API、创建 Spring Boot 项目、编写 Java 后端服务、配置数据库访问（JPA / MyBatis）、处理认证与授权（Spring Security / JWT）、实现微服务架构（Spring Cloud）、排查 Spring Boot 相关错误、审查 Java 代码质量，或执行任何与 Spring Boot / Java 后端相关的任务。</p>
</div>
<a rel="nofollow" href="/xiazai/skill9469" title="java后端编程" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span>
</a>
</div>
</div>
-
使用JavaMail发送带内嵌图片的邮件
关键在于创建MimeMultipart("related")，并将二维码字节数组作为MimeBodyPart以Content-ID头注入：
import javax.mail.*;
import javax.mail.internet.*;
import java.util.Properties;
public void sendEmailWithEmbeddedQr(String to, String subject, String htmlTemplate, byte[] qrBytes)
throws MessagingException, IOException {
Properties props = new Properties();
props.put("mail.smtp.host", "smtp.example.com");
props.put("mail.smtp.port", "587");
Session session = Session.getInstance(props);
Message message = new MimeMessage(session);
message.setFrom(new InternetAddress("no-reply@example.com"));
message.setRecipients(Message.RecipientType.TO, InternetAddress.parse(to));
message.setSubject(subject);
// 创建 multipart/related 容器（支持内嵌资源）
MimeMultipart multipart = new MimeMultipart("related");
// 添加 HTML 正文部分
MimeBodyPart htmlPart = new MimeBodyPart();
htmlPart.setContent(htmlTemplate.replace("{content}", "HelloWorld"), "text/html; charset=utf-8");
multipart.addBodyPart(htmlPart);
// 添加二维码图片作为内嵌附件（CID绑定）
MimeBodyPart imagePart = new MimeBodyPart();
imagePart.setDataHandler(new DataHandler(new ByteArrayDataSource(qrBytes, "image/png")));
imagePart.setHeader("Content-ID", "<qr-code-attachment>"); // 注意：CID值需加尖括号包裹
imagePart.setDisposition(MimeBodyPart.INLINE);
multipart.addBodyPart(imagePart);
message.setContent(multipart);
Transport.send(message);
}</qr-code-attachment>
✅ 注意事项
- Content-ID头部的值必须与HTML中src="cid:xxx"的xxx完全匹配，且必须用尖括号包裹（如
），这是RFC 2392强制要求； - 使用MimeMultipart("related")而非"mixed"，否则内嵌资源无法被客户端正确解析；
- 确保ByteArrayDataSource来自javax.activation（Java 8及以下）或使用jakarta.activation（Jakarta EE 9+）；
- 部分老旧邮件客户端（如Outlook早期版本）对Base64内联支持有限，cid方式兼容性更优。
该方案完全规避磁盘I/O，所有数据驻留内存，既满足安全合规要求（无敏感临时文件残留），又具备高并发处理能力，是生产环境推荐的最佳实践。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
