调用Microsoft Graph /me端点时mail属性有时为undefined的原因及解决方案

原因分析 #

• @onmicrosoft.com账号：这类是Microsoft 365租户的原生账号，默认在Azure AD中会自动配置mail属性，对应租户内分配的Exchange邮箱地址，所以能正常返回有效值。
• @outlook.com个人账号：mail字段仅在用户开通并配置了Exchange邮箱服务时才会填充，纯个人微软账号如果没启用对应邮箱服务，该字段就会返回undefined。
• Gmail注册的Microsoft 365账号：mail属性仅存储租户内部的Exchange邮箱地址，而这类账号的主邮箱是外部的Gmail地址，不会写入mail字段，因此返回undefined。

获取邮箱地址的替代方案 #

1. 读取userPrincipalName字段
   这个字段对所有类型的微软账号都存在，直接对应账号的登录邮箱：

   • @onmicrosoft.com账号：userPrincipalName就是其租户邮箱
   • @outlook.com账号：userPrincipalName即outlook邮箱地址
   • Gmail注册的账号：userPrincipalName就是注册用的Gmail地址

2. 解析proxyAddresses数组
   该数组包含了账号关联的所有邮箱地址（包括主邮箱和别名），其中以SMTP:（大写）开头的是主邮箱，smtp:（小写）是别名。可以通过筛选该数组获取主邮箱：

   // 示例：从proxyAddresses中提取主邮箱
   const primaryEmail = user.proxyAddresses?.find(addr => addr.startsWith('SMTP:'))?.replace('SMTP:', '');
   

3. 确认API权限
   确保调用https://graph.microsoft.com/v1.0/me时，已申请User.Read或更高权限（比如User.ReadBasic.All），否则部分字段会被隐藏。

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