Graph API中hasAttachments属性异常问题咨询

问题详情 #

使用Microsoft Graph API获取Outlook邮件详情时，遇到hasAttachments和附件isInline属性不符合预期的情况：

• 官方规则：
  • hasAttachments：邮件含1个及以上非内嵌附件时为true；无附件或所有附件均为内嵌时为false
  • isInline：标识单个附件是否为内嵌类型
• 异常场景：某邮件包含非内嵌的message_v2.rpmsg附件，但API响应中hasAttachments为false，附件的isInline（注意响应中拼写为islnline，疑似笔误）也为false

API响应示例：

{
    "@odata.etag" : "W/\"CQAAABYAAABEIDZQDkY9Q11HVLaaS/ZVAAEWzqBC\"",
    "id": "AAMkADk40TYXNzhjLWE5yzgtNGE5N...",
    "hasAttachments": false,
    "attachments": [
        {
            "@odata.type": "#microsoft.graph.fileAttachment",
            "@odata.mediaContentType": "application/x-microsoft-rpmsg-message",
            "id": "AAMkADk40TYXNzhjLWE5yzgtNGE5NS1hYTd1LT1iZELuw=",
            "lastModifiedDateTime": "2023-06-22T09:57:48z",
            "name": "message_v2.rpmsg",
            "contentType": "application/x-microsoft-rpmsg-message",
            "size": 118679,
            "islnline": false,
            "contentId": "21672D7F295E8B4D9e9C6CBD4E7EIBCB@1NDPRDØ1.PROD.OUTLOOK.COM",
            "contentLocation": null,
            "contentBytes": "qne533e9362efp6d/124Y7fJOK/QgvBg....."
        }
    ]
}

使用的Graph Explorer查询语句：

https://graph.microsoft.com/v1.0/me/mailFolders/Inbox/messages?$select=hasAttachments&$expand=attachments

排查方向 #

1. 字段拼写验证
   响应中附件的属性拼写为islnline（字母l替代了i），先确认这是复制时的笔误还是API实际返回的错误。如果是API返回的拼写错误，可能是Graph的已知问题，需关注官方修复；如果是笔误，重新核对实际响应中的isInline值。

2. 单独查询邮件详情
   避免批量查询的潜在影响，直接请求单个邮件的详情：

   GET https://graph.microsoft.com/v1.0/me/messages/{message-id}?$expand=attachments
   

   查看返回的hasAttachments和isInline是否依然异常，排除批量查询的属性计算逻辑问题。

3. 验证邮件实际属性
   通过Outlook客户端打开该邮件，确认附件的实际状态：是否显示为内嵌附件（比如嵌入邮件正文），还是独立附件。部分特殊格式附件（如rpmsg）可能被Exchange/Outlook特殊处理，导致Graph API的属性判定逻辑与客户端显示不一致。

4. 移除$select参数测试
   尝试移除$select=hasAttachments参数，请求完整的邮件字段：

   GET https://graph.microsoft.com/v1.0/me/mailFolders/Inbox/messages?$expand=attachments
   

   查看hasAttachments的值是否变化，排除$select参数导致的字段取值异常。

5. 提交官方反馈
   若以上排查均无法解决问题，大概率是Graph API的bug。收集邮件ID、API版本、完整响应示例等信息，提交至Microsoft 365 Developer Feedback门户，请求官方排查。

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