使用Java Spring发送邮件后图片内容异常的问题求助

可能的核心原因 #

• 线程安全问题（最高概率）
  批量发送邮件时如果复用了MimeMessage、MimeMessageHelper实例，或者把这些对象定义为类成员变量而非每次发送时新建，多线程环境下会出现资源串用。比如线程A正在添加imageqr的二维码资源，线程B同时操作同一个Helper实例，覆盖了cid对应的DataSource，最终导致某封邮件的cid指向了其他线程的资源。
• 二维码生成/资源加载的共享变量问题
  如果生成二维码的代码使用了静态变量存储流、DataSource，或者加载固定图片时复用了未正确隔离的流对象，线程间会意外共享资源。比如线程B生成的二维码流被线程A的邮件错误引用，就会出现陌生内容。
• 模板渲染的上下文污染
  若使用Thymeleaf等模板引擎时，复用了Context或模板上下文对象，多线程渲染HTML时可能把其他邮件的cid关联逻辑带进来，导致最终HTML里的cid指向错误资源。
• 邮件服务器传输异常（低概率）
  极少数情况下，邮件服务器的缓存或资源复用机制出错，导致某封邮件的内嵌资源被替换，但这种情况只会出现极个别案例，且无法通过代码复现。

排查与修复建议 #

• 强制线程隔离邮件实例
  每次发送邮件时，必须从JavaMailSender获取新的MimeMessage，并新建MimeMessageHelper实例，示例代码：

  // 错误：复用MimeMessageHelper
  // private MimeMessageHelper helper;
  
  // 正确：每次发送时新建
  MimeMessage message = javaMailSender.createMimeMessage();
  MimeMessageHelper helper = new MimeMessageHelper(message, true, "UTF-8");
  

• 隔离资源生成逻辑
  生成二维码、加载本地图片时，确保每次都创建新的流和DataSource，不使用静态变量存储中间结果，用完及时关闭流：

  // 示例：每次生成新的二维码DataSource
  ByteArrayOutputStream baos = new ByteArrayOutputStream();
  // 生成二维码到baos
  DataSource qrDataSource = new ByteArrayDataSource(baos.toByteArray(), "image/png");
  baos.close();
  helper.addInline("imageqr", qrDataSource);
  

• 模板上下文独立初始化
  使用模板引擎时，每次渲染都新建上下文对象，确保当前邮件的cid关联仅作用于当前上下文：

  // 正确：每次创建新Context
  Context context = new Context();
  context.setVariable("image1Cid", "image1");
  // 渲染模板
  String html = templateEngine.process("mail-template", context);
  

• 分析异常邮件原始内容
  找到那封异常邮件，查看其原始MIME源码，对比Content-ID和内嵌资源的对应关系，确认是cid被错误替换，还是资源内容本身被串用，进一步定位问题环节。

内容的提问来源于stack exchange，提问作者Thế Hải Nguyễn