Jakarta Mail发送HTML邮件因环境差异出现乱码问题求助

问题根源 #

你当前的修复代码依赖平台默认字符集，开发机Ubuntu的默认编码是UTF-8，但Docker容器的JVM默认编码可能被设为了ANSI_X3.4-1968（ASCII），导致邮件的Content-Type charset自动适配了环境编码，进而引发乱码。

具体解决思路 #

• 直接指定邮件Content-Type的编码，不依赖环境默认
  替换原有的setContent调用，明确指定UTF-8编码，同时去掉手动转码的冗余操作（Jakarta Mail原生支持UTF-8内容）：

  // 直接传入UTF-8格式的mailTextContent，无需手动转码
  htmlPart.setContent(mailTextContent, "text/html; charset=UTF-8");
  

  手动转码new String(mailTextContent.getBytes("UTF8"),"ISO-8859-1")是不必要的，反而会因为环境编码差异引入问题。

• 统一HTML头部与邮件编码
  将HTML头部的meta标签编码改为UTF-8，和邮件Content-Type保持一致，避免客户端解析时出现编码冲突：

  <meta http-equiv="Content-Type" content="text/html;charset=UTF-8">
  

• 强制Docker环境的JVM使用UTF-8编码
  在启动jar包的命令中添加JVM参数，固定默认编码：

  java -Dfile.encoding=UTF-8 -jar your-mail-app.jar
  

• 显式配置Jakarta Mail的全局编码
  在创建Session时，添加mail.mime.charset参数，强制所有邮件使用UTF-8：

  Properties props = new Properties();
  // 其他邮件配置...
  props.put("mail.mime.charset", "UTF-8");
  Session session = Session.getInstance(props, authenticator);
  

验证方法 #

修改后重新发送邮件，查看邮件源码的Content-Type是否为charset=UTF-8，同时检查特殊字符（ä、ö、€）是否正常显示。

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