Spring Integration IMAP入站适配器删除邮件时抛出异常求助

我之前碰到过类似的场景，结合Spring Integration 1.4.1的特性，给你几个针对性的解决方案：

1. 自定义搜索策略，排除已删除邮件 #

默认的SeenSearchTermStrategy只会筛选已读邮件，但不会排除已经标记为删除的邮件。当你设置shouldDeleteMessages=true后，邮件被标记为删除但可能还未被彻底清除（IMAP的删除是标记机制，需要EXPUNGE操作才会彻底移除），下一轮轮询时适配器仍会尝试拾取这些已标记删除的邮件，从而抛出MessageRemovedIOException。

你可以自定义一个SearchTermStrategy，同时筛选已读且未被删除的邮件：

@Bean
public SearchTermStrategy customSeenAndNotDeletedStrategy() {
    return (folder, session) -> {
        SearchTerm seenTerm = new FlagTerm(new Flags(Flags.Flag.SEEN), true);
        SearchTerm notDeletedTerm = new FlagTerm(new Flags(Flags.Flag.DELETED), false);
        return new AndTerm(seenTerm, notDeletedTerm);
    };
}

然后在适配器中替换原来的seenSearchTermStrategy：

.from(Mail.imapInboundAdapter(properties.getImapUrl())
        .javaMailProperties(p -> p
                .put("mail.imap.starttls.enable", "true")
                .put("mail.imap.ssl.trust", "*")
                // 新增：删除后立即执行EXPUNGE
                .put("mail.imap.expungeafterdelete", "true"))
        .searchTermStrategy(customSeenAndNotDeletedStrategy())
        .shouldDeleteMessages(true)
)

2. 配置JavaMail属性，确保删除后立即清理 #

添加mail.imap.expungeafterdelete=true属性，让IMAP客户端在删除邮件后立即执行EXPUNGE操作，彻底移除已删除的邮件，避免后续轮询时再看到这些邮件。这个属性可以直接添加到你的JavaMail配置中，如上面的代码所示。

3. 检查DeleteMailHandler的实现逻辑 #

异常中的NullPointerException大概率是因为你的DeleteMailHandler在处理邮件时，尝试访问了邮件的某些资源（比如邮件内容、附件），而这些资源在邮件被删除后已经不可用。要注意：shouldDeleteMessages=true已经让适配器负责处理删除逻辑，你的handler不需要再手动删除邮件。

如果handler里有手动删除邮件的代码，建议直接移除，避免重复删除导致的异常。

4. 升级Spring Integration版本（推荐） #

Spring Boot 1.4.1对应的Spring Integration版本是4.3.x，这个版本比较老旧，存在一些IMAP适配器的已知问题，比如删除邮件后处理逻辑的bug。升级到较新的版本（比如Spring Boot 2.x对应的Spring Integration 5.x，或者更高版本）可以解决很多这类兼容性和bug问题。

升级时只需要修改pom.xml（Maven）或build.gradle（Gradle）中的spring-boot-starter-integration版本号即可。

验证方案 #

按照上述步骤调整后，重新启动应用：

• 邮件会被正常读取并删除
• 不再出现MessageRemovedIOException和NullPointerException
• 查看mail.debug日志，确认EXPUNGE操作已执行，且轮询时不会再拾取已删除的邮件

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