Docker容器内Tomcat部署的JavaMail发送邮件失败求助

从你提供的日志来看，核心问题非常明确：Docker容器内的应用在SMTP认证时密码为空——日志里的UGFzc3dvcmQ6是Base64编码后的Password:，正常情况下应该是Password:你的实际密码的编码，这说明应用在容器环境中没有正确加载到邮件账号的密码配置。

结合本地运行正常、容器内失败的差异，我整理了针对性的排查和修复步骤：

一、先确认容器内的配置是否正确 #

这是最常见的原因，本地的配置没有正确同步到容器里：

1. 进入Docker容器，查看应用的邮件配置文件（比如WEB-INF/classes/mail.properties或Spring Boot的application.properties）：

   docker exec -it <你的Tomcat容器ID> cat /path/to/你的应用/WEB-INF/classes/mail.properties
   

   重点检查mail.smtp.password（或你配置里对应的密码字段）是否和本地完全一致，包括大小写、特殊字符。
2. 如果是用环境变量传递密码，确认Docker启动命令（或docker-compose.yml）里是否正确设置了环境变量，比如：

   docker run -d -e MAIL_PASSWORD=你的实际密码 ... 你的Tomcat镜像
   

   同时要确认应用代码里是否正确读取了这个环境变量（比如Spring的@Value("${MAIL_PASSWORD}")），没有因为环境差异导致读取失败。

二、排查配置文件的加载问题 #

如果你的应用依赖外部配置文件而非打包在WAR里：

• 检查Docker是否通过-v参数正确挂载了本地的配置文件路径，避免容器内使用的是镜像里默认的空配置。比如：

  docker run -d -v /本地的配置文件路径:/容器内的配置文件路径 ... 你的Tomcat镜像
  

三、处理含特殊字符的密码 #

如果密码包含!@#$%^&*这类特殊字符：

• 在Docker环境中传递时，需要用引号包裹（比如docker-compose.yml里的环境变量值），或者确保配置文件的编码是UTF-8，避免字符转义或编码错误导致密码变形。

四、手动测试容器内的SMTP认证 #

用工具在容器内手动测试，区分是应用代码问题还是环境配置问题：

1. 进入容器安装swaks工具：

   docker exec -it <容器ID> apt-get update && apt-get install swaks -y
   

2. 执行SMTP认证测试：

   swaks --to test@example.com --from helpdesk@folo-folo.com --server 你的SMTP服务器地址:465 --auth LOGIN --auth-user helpdesk@folo-folo.com --auth-password 你的实际密码 --ssl
   

   • 如果手动测试成功：说明是应用代码里的配置读取逻辑有问题，比如硬编码了本地路径、或者环境变量读取错误。
   • 如果手动测试失败：说明是账号密码本身或SMTP服务器的配置问题（比如Postfix是否允许Docker子网172.18.0.0/16的客户端认证）。

五、检查Postfix的SASL权限配置 #

虽然本地能正常认证，但可以确认下Postfix是否限制了Docker子网的请求：

• 查看宿主机的/etc/postfix/main.cf，检查smtpd_recipient_restrictions和sasl相关配置，确保没有拒绝172.18.0.0/16网段的认证请求。

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