Microsoft Graph /me/sendMail接口偶返200状态码但邮件未发送问题求助

故障原因 #

• 边缘节点提前截断请求：你观测到的200状态码、无后端诊断头、Content-Length为0的表现，符合Microsoft Graph边缘节点异常终止请求的特征。正常情况下请求会被转发到Exchange Online后端处理，返回202状态码和完整的request-id、x-ms-ags-diagnostic等诊断头；如果边缘节点因临时故障、流量管控、超时等原因未转发请求到后端，就会返回此类无有效信息的空响应。
• 账号权限临时受限：即使使用的令牌字符串完全一致，也可能出现令牌对应的用户账号被Exchange风险管控规则临时限制发送权限的情况，此时边缘节点校验权限后直接返回空200响应，不会触发后端的错误逻辑。
• 请求体触发隐式拦截：如果请求体中存在边缘节点规则命中的异常内容（比如特殊格式的附件元数据、被管控的收件人地址、敏感内容关键词），边缘节点会静默丢弃请求，返回空200响应，无错误提示。

修复措施 #

• 新增异常重试逻辑：针对/me/sendMail接口的响应做判定，只要返回状态码不是202，或者返回头中缺少request-id、client-request-id字段，直接触发重试。重试时需要携带Prefer: IdempotencyToken=<随机唯一UUID>请求头，避免重复发送邮件，重试间隔设置为1-3分钟即可。
• 主动添加诊断参数：所有发送请求主动携带client-request-id请求头，值为每个请求生成的唯一UUID，后续如果需要提交工单排查，可以直接用该ID查询链路日志。
• 调整请求发送速率：如果故障出现频率和请求量正相关，先将发送请求的QPS下调30%，观察故障是否消失，排除边缘流控触发的异常。
• 验证账号权限规则：使用对应账号登录Outlook网页端手动发送测试邮件，同时在Exchange管理中心检查邮件流规则，确认该账号没有被限制发送权限，也没有匹配到拦截类规则。

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