部署在Openshift的SpringBoot应用出现javax.mail.AuthenticationFailedException异常

我之前也踩过一模一样的坑！本地跑邮件功能完全正常，一部署到OpenShift就炸出javax.mail.AuthenticationFailedException，折腾了好几个小时才把问题解决，给你整理几个关键排查方向：

1. 优先检查Gmail账号的安全配置 #

这是最常见的原因，Gmail的安全机制会拦截非信任环境的登录：

• 如果你的账号开启了两步验证，绝对不能直接用原密码！必须去Google账号安全页面生成一个「应用专用密码」，用这个密码代替原密码填到配置里
• 如果没开两步验证，现在Gmail已经移除了“允许不太安全的应用”选项，还是建议开启两步验证用专用密码更稳妥；要是实在不想开，得去Google账号的「最近安全活动」里，找到来自OpenShift服务器的登录拦截记录，手动允许该登录请求

2. 排查OpenShift的环境与网络配置 #

• 环境变量校验：确认你在OpenShift里配置的邮箱用户名、密码（或专用密码）没有拼写错误，部署时有没有把配置正确注入到应用里——我之前就是不小心把密码变量名写错了，本地没问题，线上直接认证失败
• 网络连通性：OpenShift的网络策略可能会阻止出站SMTP请求，试试在pod里执行telnet smtp.gmail.com 587，看能不能连通；如果连不上，需要调整项目的网络策略，允许访问smtp.gmail.com的587或465端口
• 代理设置：如果你的OpenShift集群有出站代理，得在JavaMail配置里加上代理参数：

  spring.mail.properties.mail.smtp.proxy.host=你的代理地址
  spring.mail.properties.mail.smtp.proxy.port=你的代理端口
  

3. 检查JavaMail的配置与版本 #

从你的日志看，用的是mail-1.4.jar，这个版本太老了，对TLS的支持可能有问题：

• 先确认基础配置是否正确：

  spring.mail.host=smtp.gmail.com
  spring.mail.port=587
  spring.mail.username=你的Gmail账号@gmail.com
  spring.mail.password=你的应用专用密码
  spring.mail.properties.mail.smtp.auth=true
  spring.mail.properties.mail.smtp.starttls.enable=true
  

• 建议升级JavaMail版本，比如换成最新的Jakarta Mail依赖：

  <!-- Maven依赖 -->
  <dependency>
      <groupId>com.sun.mail</groupId>
      <artifactId>jakarta.mail</artifactId>
      <version>2.0.1</version>
  </dependency>
  

  老版本和OpenShift的容器环境兼容性可能不好，升级后大概率能解决一些隐性的认证问题

4. SSL证书信任问题 #

如果OpenShift集群用了自定义的根证书，可能会导致容器不信任Gmail的SSL证书，这时候需要把Gmail的证书导入到应用的Java信任存储里，或者在配置里临时关闭证书校验（仅测试用，生产环境不建议）：

spring.mail.properties.mail.smtp.ssl.trust=smtp.gmail.com

要是以上方法都试了还不行，建议在OpenShift的pod里写个极简的Java邮件测试类，直接运行测试，排除应用代码本身的问题，聚焦到环境配置上。

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