如何配置JavaMailSender对接Roundcube Webmail？发送请求无响应排查

我的程序开发阶段用Gmail账号可正常发送邮件，上线生产环境后需对接客户的Roundcube Webmail服务。按Roundcube提供的信息完成配置后，无报错但邮件发送请求始终未被处理。试过修改端口与协议，也检查过Roundcube的入站请求相关设置，仍无法发送邮件，换回Gmail配置一切正常。

想问：是否需要修改Roundcube的某些设置？是否存在配置错误？有没有对接Roundcube Webmail的经验，能指出问题所在？

我的应用配置如下：

spring.mail.port=587
spring.mail.protocol=smtp
spring.mail.host=mail.domain.eu
spring.mail.username=email@email.be
spring.mail.password=password

问题排查与解决方案 #

• 补全SMTP加密与认证配置：Roundcube依赖的SMTP服务器通常强制要求TLS加密和身份认证，你的配置缺失关键参数，需添加：

  spring.mail.properties.mail.smtp.starttls.enable=true
  spring.mail.properties.mail.smtp.auth=true
  

  Gmail会自动处理这些参数，但Roundcube的SMTP服务需要显式开启。

• 检查SMTP服务器端口与协议匹配：

  • 若587端口无效，尝试切换至465端口（SSL加密），对应配置改为：

    spring.mail.port=465
    spring.mail.protocol=smtps
    spring.mail.properties.mail.smtp.ssl.enable=true
    

  • 确认客户的SMTP服务器实际监听的端口，避免端口配置不匹配。

• 验证账号权限与限制：

  • 确认email@email.be账号是否被允许通过SMTP客户端发信，部分Roundcube后台会限制账号仅能通过Web界面发送邮件，需开启SMTP客户端权限。
  • 检查密码是否正确，若账号开启两步验证，需使用专用的应用密码而非登录密码。

• 排查IP白名单限制：
  很多企业邮件服务会设置IP白名单，若你的应用服务器IP不在白名单内，请求会被静默丢弃（无报错），需联系客户添加IP白名单。

• 开启DEBUG日志定位问题：
  添加日志配置获取详细交互过程，找到请求卡住的具体原因：

  logging.level.org.springframework.mail=DEBUG
  logging.level.com.sun.mail=DEBUG
  

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