部分用户调用Microsoft Graph取日历遇MailboxNotEnabledForRESTAPI错误排查

报错原因分析 #

返回的错误代码MailboxNotEnabledForRESTAPI已明确指向问题：报错的用户邮箱符合以下三种情况之一：

• 邮箱处于非活跃状态
• 邮箱已被软删除（处于回收站保留周期内）
• 邮箱托管在本地Exchange服务器而非Exchange Online

部分用户正常、部分报错的核心差异：

• 正常用户：邮箱为活跃状态的Exchange Online邮箱，满足Graph API访问的基础条件
• 报错用户：属于上述三种异常情况中的一种

除AAD Premium P2外，还需满足的条件 #

1. 用户必须持有Exchange Online相关许可证
   目标用户需要分配包含Exchange Online的许可证（如Microsoft 365 E3/E5、Office 365 Enterprise等），Graph API访问日历服务依赖Exchange Online的支持，无Exchange Online许可证的用户无法通过该API访问日历。

2. 邮箱处于活跃状态

   • 用户Azure AD账号未被禁用
   • 邮箱服务未被暂停或限制（可在Exchange管理中心查看状态）

3. 邮箱需为Exchange Online托管
   若用户邮箱是本地Exchange服务器托管，需配置Exchange Hybrid环境并启用Graph API的跨环境访问支持；未配置Hybrid的本地邮箱无法直接通过Microsoft Graph访问。

4. 应用/访问账号具备对应权限
   确保调用API的应用已获得Calendars.Read或Calendars.ReadWrite类别的权限（已完成管理员授权或用户授权，取决于权限类型）

验证步骤 #

• 在Azure AD中检查报错用户的账号状态是否为启用，以及许可证分配情况
• 在Exchange管理中心查看用户邮箱的托管位置（本地/云）和活跃状态
• 确认应用权限已正确配置并完成授权

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