GitLab分支专属环境变量无法生效问题排查

1. 环境范围的核心误解：分支名≠部署环境名 #

GitLab变量的「环境范围」字段默认是给**部署环境（如production、staging）**用的，不是分支过滤规则。你直接填分支名"a-branch-123"，GitLab会把它当成一个叫这个名字的部署环境——而你的流水线根本没部署到这个环境，自然拿不到变量。

修复：
要让变量绑定分支，得明确告诉GitLab这是分支范围：

• 编辑变量时，在「环境范围」输入框填 branch:a-branch-123；
• 或者用下拉选择「Specific branch or tag」，再输入分支名，GitLab会自动补全正确的格式。

2. 子流水线没拿到父流水线的变量 #

monorepo的子流水线默认不会自动继承父流水线的变量，哪怕父流水线能拿到THREAT_LEVEL，子流水线也不会主动获取。

修复：
触发子流水线时，显式传递变量：

trigger-child:
  stage: trigger
  trigger:
    include: ./path/to/child-ci.yml
  variables:
    THREAT_LEVEL: $THREAT_LEVEL

3. 分支名匹配不精准 #

检查你填的分支名和实际分支是否完全一致：

• GitLab分支名大小写敏感，A-Branch-123和a-branch-123是两个不同分支；
• 别加origin/前缀，直接填本地分支名a-branch-123就行。

4. 受保护分支的变量权限问题 #

如果你的a-branch-123是受保护分支，但变量没开「保护」选项，变量也不会被注入到该分支的流水线里。

修复：
编辑变量时，勾选「Protect variable」选项，让受保护分支能访问这个变量。

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