配置mail.smtp.connectiontimeout后与Office 365交互时请求时长异常延长问题求助

我之前帮团队排查过几乎一模一样的Office 365 SMTP超时问题，咱们一步步拆解原因和解决方案：

核心问题分析 #

你的配置里存在一个关键冲突：你用的是587端口（STARTTLS模式），但同时配置了smtp.socketFactory.port=465和SSLSocketFactory。

Office 365的587端口是先建立明文连接，再通过STARTTLS升级为加密连接；而465端口是直接SSL加密连接。这种混合配置会让JavaMail的连接逻辑混乱，导致连接过程中出现不必要的阻塞，最终表现为服务等待你设置的connectiontimeout时长才返回响应，而非仅在连接超时触发时等待。

其他邮件服务商可能对这种配置兼容性更好，或者它们的SMTP流程对错误配置的容忍度更高，所以没出现这个问题。

具体解决步骤 #

1. 修正SMTP配置，移除冲突的SocketFactory参数 #

删除spring.mail.properties.mail.smtp.socketFactory相关配置，修正后的application.yml如下：

spring:
  mail:
    host: ${EMAIL_HOST:smtp.office365.com}
    port: ${EMAIL_PORT:587}
    username: ${EMAIL_USERNAME}
    password: ${EMAIL_PASSWORD}
    properties:
      mail:
        smtp:
          auth: true
          connectiontimeout: 5000
          timeout: 5000
          writetimeout: 5000
          starttls:
            enable: true
          # 添加这个参数，避免等待服务器quit响应的额外延迟
          quitwait: false

2. 升级JavaMail/Jakarta Mail版本 #

旧版本的JavaMail对Office 365的STARTTLS支持存在bug，建议升级到最新稳定版：

• 如果你用Spring Boot 2.x：确保javax.mail:mail版本≥1.6.2
• 如果你用Spring Boot 3.x：确保jakarta.mail:jakarta.mail-api版本≥2.1.2

3. 代码层面的小优化（可选） #

虽然不是核心问题，但可以在发送邮件时添加异步处理，避免阻塞请求线程：

// 注入TaskExecutor或者用@Async注解
@Async
public void sendMailAsync(MimeMessage message) {
    mailSender.send(message);
}

然后在原接口里调用这个异步方法即可。

验证方法 #

修改配置后，测试两种场景：

1. 正常发送邮件：确认服务不会等待5秒/20秒，而是立即返回响应（因为你设置了@ResponseStatus(HttpStatus.ACCEPTED)）
2. 模拟连接失败（比如改个错误的host）：确认服务会在设置的connectiontimeout时长后抛出超时异常

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