Spring Integration ImapFolder生命周期异常及FolderClosedException问题排查

我配置了基于IMAP Idle的IntegrationFlow，代码如下：

Mail.imapIdleAdapter(url)
                .javaMailProperties(javaMailProperties)
                .javaMailAuthenticator(new Authenticator() {
                    @Override
                    protected PasswordAuthentication getPasswordAuthentication() {
                        return new PasswordAuthentication(username, password);
                    }
                })
                .shouldMarkMessagesAsRead(false)
                .autoCloseFolder(false)
                .shouldDeleteMessages(false)
                .transactionSynchronizationFactory(transactionSynchronizationFactory())
                .transactional(transactionInterceptor());

我希望通过伪事务机制，在消息处理成功（事务提交）后将邮件标记为SEEN，但执行Bean中的SpEL表达式时总是触发FolderClosedException，相关代码如下：

@Bean
public TransactionSynchronizationFactory transactionSynchronizationFactory() {
    ExpressionEvaluatingTransactionSynchronizationProcessor processor =
        new ExpressionEvaluatingTransactionSynchronizationProcessor();

SpelExpressionParser spelParser = new SpelExpressionParser();

processor.setAfterCommitExpression(
    spelParser.parseExpression(
        "getPayload().setFlag(T(javax.mail.Flags$Flag).SEEN, true)"));
return new DefaultTransactionSynchronizationFactory(processor);
}

处理方法中打开文件夹解析邮件的逻辑：

public MimeMessageParser parse(MimeMessage mimeMessage) {
    Folder folder = mimeMessage.getFolder();
    try (folder) {
        if (!folder.isOpen()) {
            folder.open(Folder.READ_WRITE);
        }
        return new MimeMessageParser(mimeMessage).parse();
    }
}

调试发现偶尔会出现FolderClosedException或“This operation is not allowed on an open folder”异常，极少数情况下连续调用isOpen()会得到不同结果，且当前无多线程负载。目前临时用@Retryable解决，但不想用这种方式，也不想放弃伪事务机制。请问是配置有误还是邮件提供商连接限制过严？

问题出在资源生命周期管理冲突上，并非邮件提供商限制导致，核心原因有两点：

1. parse方法使用try-with-resources自动关闭Folder，但IMAP Idle Adapter配置了autoCloseFolder(false)，意味着Adapter期望Folder保持打开状态。业务方法处理完邮件后直接关闭Folder，导致后续事务提交时执行SpEL表达式操作邮件时，Folder已被关闭，触发FolderClosedException。

2. 偶尔出现的“不允许在打开的文件夹执行操作”异常，是因为JavaMail的Folder状态并非线程安全（即便无显式多线程负载，Spring Integration内部调度如Idle重连、事务同步的异步执行也可能导致状态不一致），加上try-with-resources的自动关闭逻辑与Adapter的Folder持有逻辑冲突，引发状态混乱。

修复步骤： #

• 移除业务方法中的Folder自动关闭逻辑：既然Adapter配置了autoCloseFolder(false)，Folder的生命周期应由Adapter管理，不要在业务代码中手动关闭。修改后的parse方法：

public MimeMessageParser parse(MimeMessage mimeMessage) throws MessagingException {
    Folder folder = mimeMessage.getFolder();
    if (!folder.isOpen()) {
        folder.open(Folder.READ_WRITE);
    }
    return new MimeMessageParser(mimeMessage).parse();
}

• 优化事务同步的SpEL表达式，确保Folder状态可靠：直接操作MimeMessage的Flag依赖Folder状态，改为在SpEL中显式检查并重新打开Folder（若需要），避免状态不一致。修改后的transactionSynchronizationFactory：

@Bean
public TransactionSynchronizationFactory transactionSynchronizationFactory() {
    ExpressionEvaluatingTransactionSynchronizationProcessor processor =
        new ExpressionEvaluatingTransactionSynchronizationProcessor();

    SpelExpressionParser spelParser = new SpelExpressionParser();
    // 显式确保Folder处于打开状态后再设置SEEN标记
    processor.setAfterCommitExpression(spelParser.parseExpression("" +
            "let folder = getPayload().getFolder(); " +
            "if (!folder.isOpen()) { folder.open(javax.mail.Folder.READ_WRITE); } " +
            "getPayload().setFlag(T(javax.mail.Flags$Flag).SEEN, true)"));

    return new DefaultTransactionSynchronizationFactory(processor);
}

• 添加JavaMail属性优化连接稳定性：在javaMailProperties中补充以下配置，减少连接超时或状态异常的概率：

mail.imap.connectiontimeout=5000
mail.imap.timeout=30000
mail.imap.writetimeout=5000
mail.imap.keepalive=true

关键说明： #

• autoCloseFolder(false)的设计目的是让Adapter在Idle期间保持Folder打开，避免频繁开关连接，因此业务代码不可私自关闭Folder，否则会破坏Adapter的状态管理逻辑。
• 即便无显式多线程操作，Spring Integration的内部调度机制仍可能导致Folder状态变化，因此操作前显式检查状态是必要的。

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