如何通过Microsoft Graph API筛选当前用户所属指定显示名称的组？

DevOps 小满

2026-7-2

高效查询当前用户所属指定组的解决方案

你遇到的问题源于me/memberOf不支持通过displayName过滤，直接查询指定组又无法关联用户归属，客户端过滤大量组会拖慢登录速度。这里提供两个无需客户端过滤的高效方案：

方案一：使用`checkMemberGroups`批量检查（推荐）

这是Microsoft Graph专门为批量验证用户组归属设计的API，性能最优，仅返回用户实际所属的指定组ID。

操作步骤：

提前获取目标组ID（可缓存复用）：
调用一次请求获取指定组的ID和名称，后续无需重复查询：

GET https://graph.microsoft.com/v1.0/groups?$filter=displayName in ('Marketing Team','HR Team','IT Team')&$select=id,displayName

返回示例：

{
  "value": [
    {
      "id": "12345678-1234-1234-1234-123456789012",
      "displayName": "Marketing Team"
    },
    {
      "id": "87654321-4321-4321-4321-210987654321",
      "displayName": "HR Team"
    }
  ]
}

批量验证用户组归属：
通过POST请求传入缓存的组ID列表，直接得到用户所属的组ID：

POST https://graph.microsoft.com/v1.0/me/checkMemberGroups
Content-Type: application/json

请求体：

{
  "groupIds": [
    "12345678-1234-1234-1234-123456789012",
    "87654321-4321-4321-4321-210987654321",
    "abcdefab-abcd-abcd-abcd-abcdefabcdef"
  ]
}

返回示例（仅包含用户实际加入的组ID）：

{
  "value": [
    "12345678-1234-1234-1234-123456789012"
  ]
}

方案二：在`groups`查询中直接关联用户归属

如果不想提前缓存组ID，可直接在组查询中同时过滤名称和用户关联：

GET https://graph.microsoft.com/v1.0/groups?$filter=displayName in ('Marketing Team','HR Team','IT Team') and members/$ref eq 'https://graph.microsoft.com/v1.0/me'&$select=id,displayName

该请求会直接返回当前用户所属的指定组，无需额外处理，但性能略逊于方案一。