Scala下使用Apache Commons HtmlEmail嵌入邮件内联图片无法显示求解

• 校验内嵌资源是否成功附加到邮件
  调用setHtmlMsg前先打印email.getAttachments()的内容，确认logo已作为内嵌附件（而非普通附件）被添加，同时校验你替换到模板中的cid字符串和email.embed()返回的内容完全一致，无多余空格、转义字符。若使用远程URL作为embed的入参，需先确认该URL在服务端可正常访问，远程资源拉取失败时embed可能静默失败不抛出异常，建议优先将图片读取为本地字节流后调用重载方法嵌入：

  // 示例：从资源目录读取图片字节嵌入
  byte[] logoBytes = Files.readAllBytes(Paths.get("src/main/resources/static/logo.png"));
  ByteArrayDataSource logoDataSource = new ByteArrayDataSource(logoBytes, "image/png");
  // 第二个参数必须带正确的文件后缀，不可只写"logo"
  String cid = email.embed(logoDataSource, "company-logo.png");
  

• 校验模板替换后的最终HTML内容
  控制台打印的HTML正常不代表传给邮件的内容无异常，需确认从XML文件读取模板后，先做XML特殊字符（"、<等）的转义还原，再执行cid替换操作，避免替换后的cid被二次转义。同时校验img标签的src属性格式为src="cid:xxx"，无多余的反斜杠、引号错位等语法问题。
• 确认邮件MIME类型配置正确
  带内嵌资源的邮件必须使用multipart/related类型，若你在代码中手动指定了内容类型为text/html会导致客户端无法关联到cid资源，可在设置HTML内容前添加代码强制指定子类型：

  email.setSubType("related");
  

• 适配Outlook客户端特殊规则
  Outlook对cid资源的兼容性要求更高：
  1. 嵌入时指定的文件名必须带正确的图片后缀（.png/.jpg等），否则客户端无法识别文件类型会直接忽略该资源
  2. img标签需明确设置width、height属性，不要将cid写在CSS的background-url中
  3. 避免cid中包含特殊字符，不要给img标签套多余的链接或嵌套复杂样式

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