无法查看通过Microsoft Graph Schema Extension添加的用户自定义数据

架构老林

2026-5-25

看起来你遇到了SchemaExtension设置用户属性后无法查看的问题，我之前处理过类似的场景，给你梳理几个关键排查点和解决方法：

排查步骤与解决方法

1. 确认SchemaExtension的目标类型包含User

创建SchemaExtension时，targetTypes字段必须明确包含"User"，否则这个扩展属性不会关联到用户对象上。你可以用Graph API查询你的扩展属性详情，验证这一点：

GET https://graph.microsoft.com/v1.0/schemaExtensions/{你的扩展ID}

查看返回结果里的targetTypes数组，如果没有"User"，那这个扩展根本不会作用在用户身上，设置的值自然无法被识别。

Native应用要读写用户的自定义扩展属性，需要配置对应的权限并完成授权：

写入权限：需要User.ReadWrite.All（应用权限）或Directory.AccessAsUser.All（委派权限）
读取权限：需要User.Read.All（应用权限）或对应的委派权限
务必确认权限已经获得管理员同意（应用权限场景），或者用户已完成授权（委派权限场景）。你可以在Azure门户的「应用注册」->「权限配置」->「已授予的权限」里查看状态是否为“已授予”。

默认情况下，Graph API查询用户对象时不会返回自定义扩展属性，你需要通过$select参数主动指定。比如：

GET https://graph.microsoft.com/v1.0/users/{用户ID}?$select=id,displayName,{你的扩展ID}

如果使用SDK（比如.NET），代码示例如下：

var user = await graphClient.Users[userId]
    .Request()
    .Select($"id,displayName,{你的扩展ID}")
    .GetAsync();

如果省略$select，返回的用户对象里不会包含这个扩展属性，自然看不到已设置的值。

Azure门户的用户详情页默认不会展示自定义扩展属性，你需要手动添加：

进入Azure AD -> 用户 -> 选择目标用户 -> 点击「编辑属性」 -> 点击「添加属性」 -> 找到你的自定义扩展属性并添加，保存后就能在门户里看到它的值了。

有时候代码没有抛出错误，但实际写入可能未生效。你可以在执行写入请求后，立刻用带$select的查询验证值是否保存成功。写入请求示例：

PATCH https://graph.microsoft.com/v1.0/users/{用户ID}
Content-Type: application/json

{
    "{你的扩展ID}": "你的自定义属性值"
}

成功的话会返回204 No Content，之后再查询确认值是否存在。

如果你的SchemaExtension状态是InDevelopment，那么只有创建它的应用能访问这个扩展属性，其他应用或Azure门户可能无法读取。如果需要全局可见，需要将状态修改为Available：

PATCH https://graph.microsoft.com/v1.0/schemaExtensions/{你的扩展ID}
Content-Type: application/json

{
    "status": "Available"
}

你可以按照上面的步骤逐一排查，大概率能找到问题所在。比如我之前就碰到过查询时忘记加$select，误以为值没写入，其实已经成功存储了。

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