Spring Boot集成Gmail邮件获取求助：ImapMailReceiver连接失败

针对使用Spring Integration ImapMailReceiver 连接Gmail时出现的jakarta.mail.MessagingException: Connection dropped by server错误，以下是具体排查和解决方向：

1. 检查Gmail账户安全配置 #

• 启用IMAP访问：登录Gmail账户，进入「设置」→「转发和POP/IMAP」，确认「IMAP访问」已设置为「启用IMAP」。
• 使用应用专用密码：若账户开启了两步验证，不能直接用登录密码，需在Google账户「安全性」页面生成应用专用密码，替换连接URL中的pass部分。
• 临时开启低安全应用访问（仅测试用）：未开启两步验证的情况下，可临时开启「不太安全的应用访问」验证，但出于安全考虑，优先推荐应用专用密码方案。

2. 修正IMAP连接配置 #

Gmail IMAP强制SSL加密，需调整连接协议和属性：

// 使用imaps协议而非imap，对应SSL端口993
ImapMailReceiver imapMailReceiver = new ImapMailReceiver("imaps://username@gmail.com:appPassword@imap.gmail.com:993/INBOX");
imapMailReceiver.setJavaMailProperties(getMailProperties());

private Properties getMailProperties() {
    Properties props = new Properties();
    // 启用SSL和STARTTLS
    props.setProperty("mail.imap.ssl.enable", "true");
    props.setProperty("mail.imap.starttls.enable", "true");
    // 设置连接超时，避免过早断开
    props.setProperty("mail.imap.connectiontimeout", "15000");
    props.setProperty("mail.imap.timeout", "15000");
    return props;
}

3. 确保依赖版本兼容 #

Spring Integration 6.x及以上版本需搭配angus-mail 1.0.x系列，Maven依赖示例：

<dependency>
    <groupId>org.eclipse.angus</groupId>
    <artifactId>angus-mail</artifactId>
    <version>1.0.2</version>
</dependency>
<dependency>
    <groupId>org.springframework.integration</groupId>
    <artifactId>spring-integration-mail</artifactId>
    <version>6.1.2</version> <!-- 与Spring Boot版本匹配 -->
</dependency>

4. 排查网络连通性 #

• 测试端口是否可访问：执行telnet imap.gmail.com 993，确认网络未屏蔽993端口。
• 代理环境下需添加代理配置：

props.setProperty("mail.imap.proxy.host", "你的代理地址");
props.setProperty("mail.imap.proxy.port", "你的代理端口");

5. 开启调试日志定位问题 #

启用Java Mail调试日志，查看连接交互细节：

props.setProperty("mail.debug", "true");

日志会输出握手过程、服务器响应信息，帮助定位断开连接的具体原因。

内容的提问来源于stack exchange，提问作者Bilel Feki Dit Kaaniche