IMAP+OAuth2.0读取邮箱令牌过期后认证失败，请求排查配置

针对你遇到的IMAP OAuth2令牌过期后Java Mail复用旧令牌导致认证失败的问题，结合Spring Integration 4.3.22.RELEASE和Java Mail API 1.5.6的版本特性，给出以下排查和修复思路：

核心原因分析 #

Java Mail 1.5.6的OAuth2实现存在已知缺陷，IMAP协议下mail.imaps.forcepasswordrefresh=true的逻辑并未正确触发，即使自定义JavaMailAuthenticator返回了新令牌，底层连接仍会复用旧令牌进行认证。同时Spring Integration的ImapMailReceiver默认会复用连接池中的连接，进一步加剧了这个问题。

具体排查与修复步骤 #

1. 升级Java Mail版本（优先推荐） #

Java Mail 1.6.x及以上版本修复了OAuth2令牌刷新的关键bug，对IMAP协议的OAuth2支持更完善。你可以排除Spring Integration依赖的旧版Java Mail，引入1.6.2版本：

<!-- Maven依赖配置 -->
<dependency>
    <groupId>org.springframework.integration</groupId>
    <artifactId>spring-integration-mail</artifactId>
    <version>4.3.22.RELEASE</version>
    <exclusions>
        <exclusion>
            <groupId>com.sun.mail</groupId>
            <artifactId>javax.mail</artifactId>
        </exclusion>
    </exclusions>
</dependency>
<dependency>
    <groupId>com.sun.mail</groupId>
    <artifactId>javax.mail</artifactId>
    <version>1.6.2</version>
</dependency>

2. 确保Authenticator每次返回最新令牌 #

检查自定义JavaMailAuthenticator的实现，禁止内部缓存令牌，每次调用getPasswordAuthentication()时都主动获取最新的有效令牌：

public class OAuth2MailAuthenticator extends Authenticator {
    private final OAuth2TokenManager tokenManager;

    public OAuth2MailAuthenticator(OAuth2TokenManager tokenManager) {
        this.tokenManager = tokenManager;
    }

    @Override
    protected PasswordAuthentication getPasswordAuthentication() {
        // 每次调用都从令牌管理器获取最新有效令牌
        String validToken = tokenManager.getOrRefreshAccessToken();
        return new PasswordAuthentication(getRequestingUserName(), validToken.toCharArray());
    }
}

3. 完善Java Mail属性配置 #

除了mail.imaps.forcepasswordrefresh=true，还需要禁用其他非OAuth2的认证机制，确保IMAP服务器只使用XOAUTH2：

Properties mailProps = new Properties();
mailProps.setProperty("mail.imaps.auth.mechanisms", "XOAUTH2");
mailProps.setProperty("mail.imaps.forcepasswordrefresh", "true");
mailProps.setProperty("mail.imaps.auth.plain.disable", "true");
mailProps.setProperty("mail.imaps.auth.login.disable", "true");

ImapMailReceiver receiver = new ImapMailReceiver("imap://your-mail-server:993/inbox");
receiver.setJavaMailProperties(mailProps);
receiver.setAuthenticator(new OAuth2MailAuthenticator(tokenManager));

4. 配置Spring Integration重连机制 #

让ImapMailReceiver在认证失败后主动重新连接，强制触发新令牌获取：

// 设置认证失败后1分钟尝试重连
receiver.setReconnectInterval(60000);
// 开启错误重试，最多重试3次
receiver.setMaxFetchSize(10);
receiver.setShouldDeleteMessages(false);

5. 手动触发连接重置（兜底方案） #

如果以上步骤仍无效，可以通过Spring Integration的错误处理机制，捕获AuthenticationFailedException时手动重启ImapMailReceiver：

@Bean
public IntegrationFlow mailFlow() {
    return IntegrationFlows.from(receiver, e -> e.poller(Pollers.fixedRate(30000).errorHandler(errorHandler())))
            .handle(mailMessageHandler())
            .get();
}

private ErrorHandler errorHandler() {
    return throwable -> {
        if (throwable.getCause() instanceof AuthenticationFailedException) {
            // 手动重启接收器，强制重新获取令牌
            receiver.stop();
            receiver.start();
        }
    };
}

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