如何设置JavaMail或Apache James Message-Id头中使用的主机名

JavaMail 侧修改Message-ID域名的方法 #

• 全局参数配置：在初始化JavaMail Session前设置系统属性mail.host为你的外网可见域名，示例代码如下：

System.setProperty("mail.host", "your.public.domain.com");
Properties props = new Properties();
// 其他JavaMail配置项
Session session = Session.getInstance(props);

也可以在启动Java服务时添加JVM启动参数-Dmail.host=your.public.domain.com实现全局生效，JavaMail自动生成Message-ID时会直接使用该参数值作为@后的后缀。

• 手动指定Message-ID：构造邮件对象后直接自定义头字段，跳过JavaMail的自动生成逻辑，注意必须严格遵循<唯一标识@域名>的格式：

// 唯一标识可使用UUID、时间戳+随机数等方式生成，保证全局唯一即可
String customMessageId = "<" + UUID.randomUUID() + "@your.public.domain.com>";
message.setHeader("Message-ID", customMessageId);

• 重写生成逻辑：如果需要统一所有邮件的Message-ID生成规则，可以继承MimeMessage类重写updateMessageID()方法，自定义生成逻辑。

Apache James 侧修改Message-ID域名的方法 #

针对Apache James 3.x 版本，直接修改配置文件conf/james.properties，找到mail.messageid.domain配置项，将值修改为你的外网可见域名即可，修改后重启James服务生效，所有出站邮件的Message-ID后缀会统一替换为该域名。
如果使用的是2.x 版本，可在config.xml配置文件中找到<messageid>相关节点，配置对应域名参数即可。

后续验证 #

修改完成后发送测试邮件，查看邮件原始头的Message-ID字段确认已替换为外网域名，再测试向雅虎账号投递即可。如果仍有退信，可提取退信中的具体错误码进一步定位反垃圾拦截规则。

内容的提问来源于stack exchange，提问作者Jason K.