Microsoft Graph API获取internetMessageHeaders时缺失部分表头问题咨询
问题根因说明
该问题大概率不是权限配置错误导致,核心原因如下:
- Microsoft Graph v1.0版本的
internetMessageHeaders仅返回标准协议头的子集,你提到的From、To、Message-ID、In-Reply-To这类常用字段,Graph已经做了结构化封装,作为消息的顶级属性单独返回,不会包含在internetMessageHeaders列表中 - 你的当前请求仅指定了
$select=internetMessageHeaders,因此不会返回上述单独封装的结构化字段
排查思路
- 先确认你的业务场景是否真的需要从原始协议头中提取字段:如果仅需要获取From、To、MessageID、In-Reply-To这类通用字段,直接调用Graph的内置顶级字段即可,不需要解析原始header
- 若确实需要和Outlook属性页完全一致的全量协议头,先确认你已经申请了
Mail.Read及以上权限(如果仅能拿到部分header,权限不足的概率极低) - 验证当前返回的
internetMessageHeaders是否包含你需要的自定义头,如果自定义头也缺失再排查权限或邮件本身的属性问题
解决方案
场景1:仅需要获取通用字段(推荐方案)
直接在$select参数中追加需要的结构化字段即可,不需要解析协议头,修改后的请求示例:
https://graph.microsoft.com/v1.0/me/messages/{restID}?$select=internetMessageHeaders,from,to,inReplyTo,internetMessageId
其中字段对应关系:
- 原
From头对应from字段 - 原
To头对应to字段 - 原
Message-ID头对应internetMessageId字段 - 原
In-Reply-To头对应inReplyTo字段
场景2:需要获取全量原始协议头
如果必须拿到和Outlook属性展示完全一致的所有协议头,有两种可选方案:
- 调用beta版本接口获取更全的header列表(beta接口不保证生产可用性),请求示例:
https://graph.microsoft.com/beta/me/messages/{restID}?$select=internetMessageHeaders
- 调用接口获取邮件原始MIME内容自行解析,请求示例:
https://graph.microsoft.com/v1.0/me/messages/{restID}/$value
返回的内容即为邮件完整的EML格式源文件,包含所有原始协议头。
内容的提问来源于stack exchange,提问作者944jmc
相关产品推荐
相关产品推荐

