GitLab Job多行命令配置报错，请求排查问题原因

我编写了如下deploy_Snapshot GitLab CI任务，尝试用多行命令实现版本判断逻辑：

deploy_Snapshot:
  stage: deploy
  rules:
    - if: $CI_COMMIT_BRANCH =~ /^develop/
  script:
    - version=$(mvn help:evaluate -Dexpression=project.version -q -DforceStdout)
    - echo "Project version: ${version}"
    - |
      if [[ ${version} != *"SNAPSHOT"* ]]; then 
        echo "Only SNAPSHOT version can be deployed through develop branch.";
      else
        mvn $MAVEN_CLI_OPTS clean deploy -Dmaven.test.skip=true;
      fi

参考GitLab官方文档使用了YAML的|多行块标识，但提交后报错：

Pipeline cannot be run.
jobs:deploy_snapshot:script config should be a
string or a nested array of strings up to 10 levels deep

请问这个脚本配置哪里出问题了？

这个报错的核心原因是YAML解析时的缩进问题：你使用|多行块作为script数组的元素时，块内部的命令缩进没有和YAML结构保持一致，导致解析器误把多行内容当成了非字符串类型的嵌套结构，违反了GitLab CI对script字段的要求（必须是字符串或字符串数组）。

另外补充：GitLab CI会自动将任务名称转换为小写（deploy_Snapshot变成deploy_snapshot），但这不是导致当前报错的直接原因。

下面提供两种可行的修复方案：

方案1：拆分Shell逻辑为独立数组项 #

把if-else逻辑拆分成两个独立的条件判断命令，每个命令作为script数组的一个元素：

deploy_Snapshot:
  stage: deploy
  rules:
    - if: $CI_COMMIT_BRANCH =~ /^develop/
  script:
    - version=$(mvn help:evaluate -Dexpression=project.version -q -DforceStdout)
    - echo "Project version: ${version}"
    - if [[ ${version} != *"SNAPSHOT"* ]]; then echo "Only SNAPSHOT version can be deployed through develop branch."; fi
    - if [[ ${version} == *"SNAPSHOT"* ]]; then mvn $MAVEN_CLI_OPTS clean deploy -Dmaven.test.skip=true; fi

这种写法完全规避了YAML多行块的缩进问题，兼容性最好。

方案2：修正多行块的缩进格式 #

如果想保留多行Shell脚本的可读性，需要确保|块内部的命令缩进比if语句多2个空格（或统一的缩进单位），保持YAML结构的一致性：

deploy_Snapshot:
  stage: deploy
  rules:
    - if: $CI_COMMIT_BRANCH =~ /^develop/
  script:
    - version=$(mvn help:evaluate -Dexpression=project.version -q -DforceStdout)
    - echo "Project version: ${version}"
    - |
      if [[ ${version} != *"SNAPSHOT"* ]]; then 
          echo "Only SNAPSHOT version can be deployed through develop branch.";
      else
          mvn $MAVEN_CLI_OPTS clean deploy -Dmaven.test.skip=true;
      fi

也可以用>折叠块（会去掉换行，但逻辑依然生效），同样需要保证缩进正确：

deploy_Snapshot:
  stage: deploy
  rules:
    - if: $CI_COMMIT_BRANCH =~ /^develop/
  script:
    - version=$(mvn help:evaluate -Dexpression=project.version -q -DforceStdout)
    - echo "Project version: ${version}"
    - >
      if [[ ${version} != *"SNAPSHOT"* ]]; then 
        echo "Only SNAPSHOT version can be deployed through develop branch.";
      else
        mvn $MAVEN_CLI_OPTS clean deploy -Dmaven.test.skip=true;
      fi

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