Spring Integration使用IMAP无法读取收件箱外已发送、垃圾箱邮件

核心原因及对应修复方案 #

• 问题1：文件夹路径命名错误
  不同邮件服务商的已发送、垃圾箱等系统文件夹命名规则差异极大，不存在通用的INBOX.Sent格式路径：
  • 部分服务商使用/作为层级分隔符而非.
  • 中文服务商通常直接使用中文名称，如腾讯企业邮的已发送文件夹直接叫已发送
  • 海外服务商命名也不统一：Gmail为[Gmail]/已发送邮件，Outlook为Sent Items
    修复方法：运行以下测试代码获取当前邮箱所有文件夹的准确全名，替换URL中的路径部分：

  public void listAllMailFolders() throws Exception {
      Properties props = new Properties();
      props.put("mail.store.protocol", "imaps");
      Session session = Session.getDefaultInstance(props);
      Store store = session.getStore("imaps");
      store.connect("你的IMAP服务器地址", 端口, "邮箱账号", "邮箱密码");
      Folder[] allFolders = store.getDefaultFolder().list("*");
      for (Folder folder : allFolders) {
          System.out.println("文件夹完整路径：" + folder.getFullName());
      }
      store.close();
  }
  

• 问题2：默认搜索策略匹配不到已发送邮件
  Spring Integration IMAP 适配器默认的搜索策略仅匹配*未读（未标记SEEN）*的邮件，而已发送文件夹里的邮件默认全部是已读状态，自然无法被检索到。你注释了自定义的UnreadSearchTermStrategy但没有替换为适配已发送文件夹的策略，依然会走默认逻辑。
  修复方法：自定义搜索策略匹配你需要的邮件范围，例如拉取最近30天的所有已发送邮件：

  public class SentMailSearchTermStrategy implements SearchTermStrategy {
      @Override
      public SearchTerm generateSearchTerm(Flags supportedFlags, Folder folder) {
          // 拉取最近30天的邮件，避免拉取全部历史
          Calendar calendar = Calendar.getInstance();
          calendar.add(Calendar.DATE, -30);
          return new ReceivedDateTerm(ComparisonTerm.GE, calendar.getTime());
      }
  }
  

  然后在已发送适配器中配置该策略，同时添加自定义用户标记避免重复处理：

  .from(Mail.imapInboundAdapter(imapSentUrl())
    .searchTermStrategy(new SentMailSearchTermStrategy())
    .userFlag("sentMailProcessedFlag") // 自定义标记，标记已处理的已发送邮件
    .simpleContent(true)
    // 其余配置不变
  )
  

• 问题3：可开启调试日志定位细节问题
  如果修改后依然无法正常读取，把mail.debug属性改为true，控制台会打印完整的IMAP交互日志，可以直接看到是否成功连接到目标文件夹、搜索请求返回的邮件数量，快速定位剩余问题。

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