使用GRAPH API访问邮箱消息报错：MailboxNotEnabledForRESTAPI与ErrorInvalidUser

异常详情 #

• MailboxNotEnabledForRESTAPI 异常
  错误代码：MailboxNotEnabledForRESTAPI
  错误信息：The mailbox is either inactive, soft-deleted, or is hosted on-premise.
  背景：邮箱处于活跃状态（可正常访问邮件），仅托管于Exchange Online（EXO），通过Graph Explorer登录授权后可正常访问邮件，已验证accessToken配置正确，排除应用注册问题。

• ErrorInvalidUser 异常
  错误代码：ErrorInvalidUser
  错误信息：The requested user 'manoj.a.patel@outlook.com' is invalid.
  背景：该邮箱同样活跃且可正常访问。

账户背景 #

两个邮箱为近期创建，共享Office 365家庭版许可证，已添加到Azure AD作为用户；账户拥有所需全部权限，登录Azure账户可查看已注册应用等详情；怀疑邮箱未与Azure应用ID正确关联（虽已添加为AD用户）。

可正常执行的请求 #

获取用户列表的代码可正常返回3个用户及邮箱地址：

var client = GetAuthenticatedGraphClient(config);
var graphRequest = client.Users.Request();
var results = graphRequest.GetAsync().Result;

触发异常的代码 #

访问邮箱收件箱消息时触发异常：

var inboxMessages = client.Users["manoj.a.patel@outlook.com"].
              MailFolders["inbox"].Messages.Request().Expand("attachments").Top(20).GetAsync();
var response = inboxMessages.Result;

可能的原因及解决方案 #

针对 MailboxNotEnabledForRESTAPI 异常 #

1. 启用Exchange Online邮箱的API访问权限
   新创建的EXO邮箱可能默认未开启Graph API依赖的服务项，通过Exchange Online PowerShell执行以下命令启用：

   Set-CASMailbox -Identity <目标邮箱地址> -EwsEnabled $true -OWAEnabled $true
   

   重点确保EwsEnabled和OWAEnabled设为$true，这两项是Graph API访问邮箱的基础前提。

2. 验证许可证服务组件
   检查Azure AD用户的许可证详情，确认已分配Exchange Online相关服务组件（如Exchange Online (Plan 1)），Office 365家庭版共享账户需确保邮箱服务已激活。

针对 ErrorInvalidUser 异常 #

1. 改用用户Object ID访问
   对于@outlook.com域名的邮箱，直接使用邮箱地址可能无法被Graph API正确识别，建议先获取用户的Object ID再发起请求：

   var targetUser = client.Users.Request().Filter("mail eq 'manoj.a.patel@outlook.com'").GetAsync().Result.FirstOrDefault();
   var inboxMessages = client.Users[targetUser.Id].MailFolders["inbox"].Messages.Request().Expand("attachments").Top(20).GetAsync();
   

2. 检查用户主体名称（UPN）一致性
   确认Azure AD中该用户的User principal name是否与邮箱地址一致，若不一致，需使用UPN作为用户标识符，而非邮箱地址。

通用排查点 #

1. 确认权限范围与授权状态
   应用注册需添加Mail.Read或Mail.ReadWrite的应用权限（而非委托权限），且已完成管理员同意；若使用委托权限，需确保登录用户拥有目标邮箱的共享访问权限。

2. 等待同步延迟
   新创建的Azure AD用户与EXO邮箱之间可能存在同步延迟，建议等待30分钟至1小时后重试请求。

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