Microsoft Graph API指定mailFolder创建MIME message报UnableToDeserializePostBody错误问询

核心原因 #

你遇到的报错属于微软Graph API的接口设计差异问题：

• POST /users/{id|userPrincipalName}/messages 接口支持直接传入base64编码的原始MIME内容，请求头Content-Type设为text/plain即可正常解析
• POST /users/{id|userPrincipalName}/mailFolders/{id}/messages 接口不支持原始MIME内容的直接传入，必须将MIME内容包裹为指定的JSON结构才能正常识别

修复方案 #

1. 修改请求头Content-Type取值，从原有的text/plain改为application/json
2. 调整请求体结构，把你现有的base64格式MIME字符串按如下格式封装：

{
  "@microsoft.graph.payloadContentType": "message/rfc822",
  "contentBytes": "<你的base64编码MIME内容>"
}

调整后重新发起请求即可正常创建指定文件夹下的MIME格式消息。

额外排查手段 #

如果调整后仍然报错，可以通过以下方式获取更详细的错误信息：

• 在请求URL末尾添加$debug参数，返回的报错信息会包含具体的字段解析失败原因
• 检查传入的mailFolder ID是否正确，确认当前应用账号拥有该文件夹的写入权限，权限不足的场景下也会偶发映射为同样的反序列化报错
• 校验你的base64字符串是否存在换行、空格等多余不可见字符，JSON封装时需要保证字符串完整无多余字符

同类问题说明 #

该问题属于Graph API的已知设计差异，大量开发者在复用根路径创建MIME消息的代码到指定文件夹接口时都会触发该错误，不属于你本地代码的格式问题。

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