IMAP的UNDELETED查询未返回Office365无标记消息的原因及解决方法

问题根因 #

1. Office365的IMAP服务对UNDELETED搜索指令的实现未严格遵循RFC 3501标准：标准定义中UNDELETED应匹配所有未携带\Deleted标记的邮件，但Office365的逻辑中该指令仅匹配曾被标记为删除、后又撤销删除操作的邮件，从未被设置过任何标记的邮件不会被纳入该搜索的结果范围。
2. 你拉取的邮件flags属性为空，说明这些邮件从未被设置过包括\Deleted在内的任何标记，自然无法被UNDELETED指令命中；而ALL指令不做状态过滤，所以可以正常返回所有邮件ID。
3. 部分Office365租户开启了IMAP搜索优化策略，未被操作过的无标记邮件不会被纳入状态类搜索的索引库，进一步导致UNDELETED搜索无返回。

修复方案 #

• 优先替换搜索条件：使用NOT DELETED替代UNDELETED作为搜索指令，Office365对该组合搜索逻辑的兼容性更高，可正确匹配所有未携带\Deleted标记的邮件，包括flags为空的全新邮件。
• 若必须使用UNDELETED指令，可先对目标文件夹执行一次空标记写入操作：调用STORE * +FLAGS ()指令，该操作不会修改邮件的实际标记属性，但会触发Office365更新所有邮件的状态索引，之后再执行UNDELETED搜索即可正常返回结果。
• 执行搜索前先刷新文件夹索引：调用EXAMINE <目标文件夹名>或SELECT <目标文件夹名>指令刷新当前文件夹的IMAP索引，避免因Office365的索引延迟（通常1-2分钟）导致新同步的邮件无法被状态类搜索命中。
• 确认账号权限：检查你使用的认证账号/应用令牌是否开通了IMAP的完整读写权限，部分受限权限的令牌仅允许执行ALL等基础搜索，无法触发状态类搜索的逻辑。

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