如何通过GitLab API获取指定项目的所有成员？

你调用GET /projects/:id/members拿不到全量成员是接口本身的逻辑限制，和令牌本身的创建来源无关：这个接口默认仅返回直接添加到项目内的成员，不会返回从祖先群组继承、跨项目分享关联进来的成员，令牌对应账号权限不足时也会出现结果截断。

前置要求 #

• 个人访问令牌必须勾选read_api权限范围
• 令牌对应账号对目标项目至少拥有Reporter及以上权限，自建实例需确认管理员未开启「非管理员仅可见同组成员」的权限限制

正确调用接口 #

直接调用包含所有来源成员的专用接口即可：

GET /projects/:id/members/all

参数说明 #

• 路径参数:id：支持传入项目数字ID，或者URL编码后的项目完整路径（例如项目路径为groupA/subgroupB/demo-project，编码后为groupA%2FsubgroupB%2Fdemo-project）
• 分页参数（必传，否则会漏数）：GitLab接口默认单页最多返回20条结果，拉全量时需配置：
  • per_page=100：设置单页返回最大条目数（单页上限为100）
  • page=N：指定拉取页码，从1开始递增，直到接口返回空数组时停止拉取
• 可选扩展参数：
  • 追加with_sources=true时，返回结果会额外标注每个成员的加入来源（直接添加/群组继承/项目分享）
  • 追加query=关键词可以按用户名、姓名筛选匹配的成员

调用示例（curl） #

curl --header "PRIVATE-TOKEN: 替换为你的个人访问令牌" \
"https://你的GitLab实例域名/api/v4/projects/替换为项目ID/members/all?per_page=100&page=1"

结果异常排查 #

如果调用上述接口仍有成员缺失，检查两项配置：

1. 确认项目未开启群组分享锁定：开启share_with_group_lock后，跨群组分享的成员不会出现在成员列表中
2. 确认实例未开启层级外分享限制：开启prevent_sharing_groups_outside_hierarchy后，不在项目所属群组层级内的分享组成员不会被返回

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