GitLab流水线执行Gradle release触发3次额外构建的问题求助

问题根源 #

你推测的原因是对的：Gradle Release插件（比如常用的net.researchgate.release）在执行release任务时，会自动完成版本号递增、提交版本变更、创建Git标签并推送到远程仓库这些操作。而GitLab默认会对任何分支推送、标签创建事件触发新的流水线，这就是你看到额外构建的核心原因。

优先解决方法：给Gradle提交信息加[skip ci]标记 #

GitLab原生支持识别提交信息中的[skip ci]或[ci skip]标记，遇到这类提交时会自动跳过流水线触发。直接修改你的Gradle配置，让Release插件生成的提交信息带上这个标记：

在项目的build.gradle中添加配置：

plugins {
  id 'net.researchgate.release' version '你的插件版本号' // 替换为实际使用的版本
}

release {
  // 自定义发布版本的提交信息，加入[skip ci]
  releaseCommitMessage = "[skip ci] Release version \${version}"
  // 自定义下一开发快照版本的提交信息，加入[skip ci]
  newVersionCommitMessage = "[skip ci] Prepare next development version"
  // 可选：给标签信息也加标记，避免标签推送触发流水线
  tagMessage = "[skip ci] Tag release \${version}"
}

这样Gradle Release执行的所有Git操作都会带上跳过标记，GitLab不会为这些操作触发额外流水线。

其他备选方案 #

如果不想修改Gradle配置，也可以通过GitLab流水线规则或脚本调整来解决：

方案1：用GitLab工作流规则过滤特定提交/标签 #

在你的.gitlab-ci.yml顶部添加全局工作流规则，排除Release插件产生的提交或标签：

workflow:
  rules:
    # 排除Release插件默认的提交信息
    - if: '$CI_COMMIT_MESSAGE =~ /^Release |^Prepare next development version/'
      when: never
    # 排除标签触发的流水线（如果不需要标签构建）
    - if: '$CI_COMMIT_TAG'
      when: never
    # 其他情况正常触发流水线
    - when: always

方案2：调整流水线脚本，移除多余Git操作 #

你的before_script中git checkout -b $CI_COMMIT_BRANCH是多余的——GitLab流水线已经在当前分支的工作目录中执行，不需要重新创建分支。删掉这一步可以避免不必要的Git事件：

before_script:
  - git remote set-url origin https://gitlab-ci-token:$CICD_GIT_TOKEN@$CI_SERVER_HOST/$CI_PROJECT_PATH.git
  - git config --global user.email 'me@email.com'
  - git config --global user.name 'Gitlab (Me)'

另外注意你的docker-build任务中有个变量错误：docker push命令里的PROJECT_VERSION应该加上$符号，否则会推送名为PROJECT_VERSION的镜像标签，修正后：

docker-build:
  stage: package
  script:
  - docker build -t registry.gitlab.com/me/myproject:$PROJECT_VERSION .
  - docker login -u gitlab-ci-token -p $CI_BUILD_TOKEN registry.gitlab.com
  - docker push registry.gitlab.com/me/myproject:$PROJECT_VERSION

内容的提问来源于stack exchange，提问作者D. Joe