GitLab List project variables API无法返回全部项目变量的原因咨询

• 继承变量未被API返回：CI/CD设置页面显示的变量可能包含从上级组或GitLab实例继承的内容，但/projects/[PROJECT-ID]/variables API仅返回项目自身定义的变量，不会包含继承的组/实例级变量。若要获取继承的变量，需调用对应组或实例的变量API。
• 环境作用域过滤：如果变量设置了特定环境作用域（如仅生产环境可用），默认API请求不会返回这类变量。需添加参数指定环境范围，比如用filter[environment_scope]=*匹配所有环境：

  GET https://gitlab.com/api/v4/projects/[PROJECT-ID]/variables?filter[environment_scope]=*
  

• 权限不足：你的API令牌可能缺少必要权限：
  • 需确保令牌拥有read_repository或api权限；
  • 若变量是受保护变量，令牌持有者需为项目维护者/所有者，或拥有protected_variables权限。
• 分页限制：变量数量较多时API会自动分页，默认每页20条。可通过page和per_page参数获取全部内容，例如：

  GET https://gitlab.com/api/v4/projects/[PROJECT-ID]/variables?page=2&per_page=100
  

• 变量类型差异：注意区分CI/CD自定义变量与GitLab预定义变量，后者仅在CI运行时生效，不会出现在设置页面或API返回结果中。

这并非GitLab的Bug，而是API设计逻辑与页面展示范围不同导致的差异。

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