outlook.office365.com IMAP BODY/TEXT搜索近期失效如何确认功能变更

功能变更确认渠道 #

• 直接通过IMAP协议的能力查询命令校验服务端支持项：建立IMAP连接后发送a001 CAPABILITY命令，查看返回的能力列表中搜索相关字段。微软近年对Exchange Online的IMAP服务做过全文索引架构切换，BODY、TEXT类正文搜索已经从原始内容逐字扫描改为依赖服务端预建的全文索引。注意不要认为命令不报错就代表功能正常：微软的IMAP实现对部分调整过逻辑的搜索条件不会返回Unknown search criterion错误，仅会在索引未覆盖对应邮件时直接返回空结果，和你遇到的现象完全吻合。
• 企业租户可通过M365管理中心查看官方变更公告：使用租户全局管理员账号登录M365管理中心，进入Exchange Online的服务健康页面，可查询近6个月内IMAP协议相关的功能迭代记录，2023年底到2024年微软确实分批次推送了IMAP正文搜索逻辑的调整，和你描述的无报错、仅BODY/TEXT条件失效、网页端搜索正常的表现完全匹配——网页端搜索走的是独立的全量索引链路，和IMAP的搜索索引不是同一套。
• 提交官方支持工单确认租户侧功能状态：个人账号或无管理员权限的用户，可通过Outlook网页端的帮助入口提交IMAP功能问题，明确说明同关键词网页端可命中、IMAP调用BODY/TEXT无报错返回空的现象，支持人员可后台查询对应账号所属租户的IMAP功能开关配置，确认是否被切到了新的正文搜索策略。

临时兼容方案 #

目前可落地的规避方式：

1. 优先用SUBJECT、SENDER、DATE等可正常生效的条件拉取小范围邮件集合，再在PHP侧拉取邮件正文做本地关键词匹配，完全绕开服务端BODY搜索的不可靠问题
2. 可测试a002 SEARCH FUZZY BODY "你的关键词"命令，部分开启了模糊搜索能力的租户，该命令可以正常命中索引内的正文内容
3. 不要依赖服务端实现NOT、OR这类组合搜索逻辑，微软的IMAP实现长期存在RFC3501标准支持不全的问题，这类逻辑放在客户端侧实现稳定性更高，避免后续服务端调整再次出现兼容问题

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