Wildfly/JBoss发送的邮件无法通过Gmail验证问题求助

嘿，这个问题我之前帮不少开发者搞定过——本质是Gmail这类主流邮箱依赖SPF、DKIM、DMARC这些邮件身份验证机制，你的配置大概率没覆盖这些验证环节，导致Gmail不信任邮件来源。咱们一步步来排查解决：

1. 先把Sendmail的基础配置捋顺 #

Wildfly是靠本地sendmail发邮件，所以首先得确保sendmail本身能正确关联你的发送域名：

• 打开sendmail的sendmail.mc配置文件，确保加了正确的MASQUERADE_AS参数（比如你的域名是yourdomain.com）：

  MASQUERADE_AS(`yourdomain.com')dnl
  FEATURE(`masquerade_envelope')dnl
  FEATURE(`masquerade_entire_domain')dnl
  

  改完后重新生成sendmail.cf，再重启sendmail服务。
• 一定要确认sendmail服务器的**反向DNS（PTR记录）**指向你的发送域名——Gmail会检查IP的反向解析是否和发件域名匹配，这是最基础的信任门槛。

2. 配置SPF记录（Sender Policy Framework） #

SPF是你域名的DNS记录，用来告诉邮箱服务商“哪些IP有权代表我这个域名发邮件”。

• 登录你的域名DNS管理后台，添加一条TXT类型的SPF记录，格式参考：

  v=spf1 ip4:你的sendmail服务器IP include:_spf.google.com ~all
  

  （如果还有其他服务商帮你发邮件，记得把对应的include加上；~all是软失败模式，等测试稳定后可以改成-all硬失败，严格拦截非授权IP的邮件）

3. 配置DKIM签名（DomainKeys Identified Mail） #

DKIM会给邮件加个加密签名，Gmail可以通过你域名DNS里的公钥验证这个签名，确认邮件没被篡改且确实来自你的域名。推荐用opendkim来配置：

1. 先安装opendkim，然后生成密钥对：

   opendkim-genkey -d yourdomain.com -s mail
   

   这会生成mail.private（私钥）和mail.txt（公钥）两个文件。
2. 把私钥放到/etc/opendkim/keys/yourdomain.com/目录，设置正确的权限：

   chown opendkim:opendkim /etc/opendkim/keys/yourdomain.com/mail.private
   chmod 600 /etc/opendkim/keys/yourdomain.com/mail.private
   

3. 编辑/etc/opendkim.conf，添加这些配置：

   Domain                  yourdomain.com
   Selector                mail
   KeyFile                 /etc/opendkim/keys/yourdomain.com/mail.private
   SenderHeaders           From
   

4. 在sendmail的sendmail.mc里加个DKIM钩子：

   INPUT_MAIL_FILTER(`opendkim', `S=inet:8891@localhost')dnl
   

5. 把mail.txt里的公钥内容添加到域名的DNS记录中，类型选TXT，主机记录填mail._domainkey。

4. 配置DMARC记录（Domain-based Message Authentication, Reporting, and Conformance） #

DMARC是给邮箱服务商的“规则手册”，告诉它们当SPF或DKIM验证失败时该怎么处理，还能给你发验证报告。

• 去域名DNS后台加一条TXT类型的DMARC记录，主机记录填_dmarc，内容参考：

  v=DMARC1; p=none; sp=none; rua=mailto:dmarc@yourdomain.com; ruf=mailto:dmarc@yourdomain.com; fo=1
  

  （p=none是监控模式，先收集几天报告确认验证都正常了，再改成p=quarantine（放到垃圾邮件）或p=reject（直接拒收））

5. 检查Wildfly的邮件会话配置 #

别让Wildfly的配置拖后腿，确保standalone.xml里的邮件会话用的是你配置了验证的域名，比如：

<mail-session name="default" jndi-name="java:jboss/mail/Default">
    <smtp-server outbound-socket-binding-ref="mail-smtp" from="noreply@yourdomain.com"/>
</mail-session>

这里的from地址一定要用你的正式域名，别用user@localhost这种本地主机名，不然Gmail肯定不认。

6. 验证结果 #

发一封测试邮件到Gmail，然后查看邮件原始内容：点击右上角三个点 -> 显示原始内容，找Authentication-Results字段，里面会显示SPF和DKIM的验证状态，如果看到spf=pass、dkim=pass，就说明验证成功了，Gmail也不会再显示那个无法确认发送方的提示了。

内容的提问来源于stack exchange，提问作者Eugênio Fonseca