使用EWS与SOAP导出O365邮箱邮件遇500错误求助

• 校验SOAP信封格式

  • 核对命名空间：必须正确使用http://schemas.microsoft.com/exchange/services/2006/messages（消息命名空间）和http://schemas.microsoft.com/exchange/services/2006/types（类型命名空间），信封、头、体的命名空间不能写错。
  • 检查请求结构：<ItemIds>节点下的<ItemId>要确保Id和ChangeKey属性格式正确（ChangeKey可选但建议带上，避免因版本不匹配报错），注意ItemId不能有截断、转义错误。
  • 验证XML语法：用XML校验工具扫一遍SOAP信封，排查未闭合标签、特殊字符未转义（比如&、<、>要转成实体）这类低级错误。

• 确认应用权限配置

  • 虽然OAuth认证没问题，但要确保Azure AD应用已配置Exchange.ManageAsApp应用权限（ExportItems必须用这个应用权限，委托权限不适用），且完成了管理员同意。
  • 若用委托权限，要确认登录用户对目标邮箱有完全访问权限，但优先推荐用应用权限方式。

• 检查请求头完整性

  • 必须设置Content-Type: text/xml; charset=utf-8，Exchange Online对这个头的要求很严格，不能省略charset或用其他类型。
  • SOAPAction头要准确设置为http://schemas.microsoft.com/exchange/services/2006/messages/ExportItems，这个头必须和操作名称完全匹配。

• 验证待导出项有效性

  • 先确认ItemId对应的是目标邮箱里存在的邮件（ExportItems只能导出邮件、日历项这类可导出项目，文件夹不行）。
  • 先用GetItem请求测试这个ItemId，能正常返回项信息的话，再尝试ExportItems，排除项本身的问题。

• 开启详细日志

  • 在代码里开启EWS的详细日志，捕获完整的请求和响应（包括所有头信息）。Exchange Online的500错误有时会在响应XML里藏更具体的诊断信息，别只看HTTP状态码。
  • 用EWS Managed API的话，设置ExchangeService.TraceEnabled = true就能拿到日志；自定义SOAP请求的话，要把发送的完整XML和收到的响应都记录下来。

• 测试小文件排除大小问题

  • 先找个小邮件测试ExportItems请求，排除因邮件过大触发Exchange Online的请求大小限制的情况。单次ExportItems请求有大小上限，超了会直接返回500错误。

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