GitLab CI/CD中使用Bash Case语句设置变量失效问题排查

1. Case语句语法不规范（最常见） #

Bash的Case语句要求每个分支必须以;;结尾，若漏写或使用错误符号（如单个;），会导致分支匹配逻辑混乱，*分支可能无法触发。

错误示例：

case $CI_COMMIT_BRANCH in
  staging)
    SSH_HOST=$SSH_HOST_STAGING
    SSH_PRIVATE_KEY=$SSH_PRIVATE_KEY_STAGING
  master)
    SSH_HOST=$SSH_HOST_MASTER
    SSH_PRIVATE_KEY=$SSH_PRIVATE_KEY_MASTER
  *)
    SSH_HOST=$SSH_HOST_DEV
    SSH_PRIVATE_KEY=$SSH_PRIVATE_KEY_DEV
esac

此处staging分支未加;;，匹配后会继续执行后续分支逻辑，甚至跳过*分支。

正确写法：

case "$CI_COMMIT_BRANCH" in
  staging)
    SSH_HOST="$SSH_HOST_STAGING"
    SSH_PRIVATE_KEY="$SSH_PRIVATE_KEY_STAGING"
    ;;
  master)
    SSH_HOST="$SSH_HOST_MASTER"
    SSH_PRIVATE_KEY="$SSH_PRIVATE_KEY_MASTER"
    ;;
  *)
    SSH_HOST="$SSH_HOST_DEV"
    SSH_PRIVATE_KEY="$SSH_PRIVATE_KEY_DEV"
    ;;
esac

2. CI_COMMIT_BRANCH变量为空或未正确传递 #

GitLab CI中，CI_COMMIT_BRANCH仅在分支流水线中存在；若为标签流水线、合并请求流水线或手动触发的非分支流水线，该变量会为空。此时Case匹配空字符串，不会触发*分支（除非显式处理空值）。

解决方法：先处理空值场景，或给变量设置默认值：

case "${CI_COMMIT_BRANCH:-unknown}" in
  staging)
    #  staging分支逻辑
    ;;
  master)
    # master分支逻辑
    ;;
  *)
    # 覆盖空值和其他分支情况
    SSH_HOST="$SSH_HOST_DEV"
    SSH_PRIVATE_KEY="$SSH_PRIVATE_KEY_DEV"
    ;;
esac

3. 错误在variables块中使用Bash Case #

GitLab CI的variables块仅支持静态值或预定义变量，无法执行Bash逻辑。若将Case语句写在此处，会把整个语句作为字符串赋值给变量，而非执行它。

错误示例：

variables:
  SSH_HOST: |
    case $CI_COMMIT_BRANCH in
      staging) echo $SSH_HOST_STAGING ;;
      master) echo $SSH_HOST_MASTER ;;
      *) echo $SSH_HOST_DEV ;;
    esac

正确写法：将Case逻辑放在script块中，通过export设置环境变量：

deploy:
  script:
    - |
      case "$CI_COMMIT_BRANCH" in
        staging)
          export SSH_HOST="$SSH_HOST_STAGING"
          export SSH_PRIVATE_KEY="$SSH_PRIVATE_KEY_STAGING"
          ;;
        master)
          export SSH_HOST="$SSH_HOST_MASTER"
          export SSH_PRIVATE_KEY="$SSH_PRIVATE_KEY_MASTER"
          ;;
        *)
          export SSH_HOST="$SSH_HOST_DEV"
          export SSH_PRIVATE_KEY="$SSH_PRIVATE_KEY_DEV"
          ;;
      esac
    - ssh-add - <<< "$SSH_PRIVATE_KEY"
    # 后续部署命令

4. 错误转义* #

Bash Case中的*是通配符，用于匹配任意字符串，不需要转义。若转义为\*，只会匹配字面量*字符，自然不会触发预期的“其他分支”逻辑，直接保留*)即可。

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