GitLab CI标签触发异常：命令行创建标签未触发指定Job

我来帮你排查并解决这个问题，你遇到的情况很常见，主要是CI配置的规则写法或者触发逻辑的问题，咱们一步步来：

一、先分析问题根源 #

你当前的CI配置里，only.refs同时写了tags和正则表达式，但GitLab CI对这种组合的解析可能和你预期的不一样。tags是特殊关键字（代表所有标签推送事件），而正则条目是匹配分支/标签名称，这种并列写法可能导致命令行推送的标签没有被正确匹配到。另外，旧的only/except语法有时候会有逻辑歧义，推荐用更清晰的rules语法替代。

二、修正CI配置（核心解决方案） #

把你的deploy-prep Job配置改成以下两种方式之一，就能确保命令行推送的符合规则的标签触发Job：

方式1：使用only: tags的正则过滤（简化版） #

这种写法明确指定只匹配符合正则的标签：

deploy-prep:
  when: manual
  only:
    tags:
      - /^v\d+\.\d+\.\d+$/

这里的正则/^v\d+\.\d+\.\d+$/是更严谨的写法，要求标签必须是vX.Y.Z格式（X/Y/Z都是数字），避免了原正则中允许多余点的问题。

方式2：使用推荐的rules语法（更灵活） #

rules是GitLab CI的新语法，逻辑更清晰，可读性更强：

deploy-prep:
  when: manual
  rules:
    - if: '$CI_COMMIT_TAG =~ /^v\d+\.\d+\.\d+$/'

这个规则的意思是：当存在CI_COMMIT_TAG变量（即触发的是标签流水线），且标签名匹配vX.Y.Z格式时，才会创建这个手动触发的Job。

三、确保Maven Release插件的推送行为正确 #

Maven Release插件默认会自动推送标签，但要确认没有禁用推送或者添加了阻止CI触发的参数：

1. 检查你的pom.xml中maven-release-plugin的配置，确保pushChanges是true（默认值），且没有设置gitPushOptions为--no-ci：

<plugin>
  <groupId>org.apache.maven.plugins</groupId>
  <artifactId>maven-release-plugin</artifactId>
  <version>3.0.0</version>
  <configuration>
    <!-- 确保开启推送 -->
    <pushChanges>true</pushChanges>
    <!-- 不要添加--no-ci，否则会阻止GitLab触发流水线 -->
    <!-- <gitPushOptions>--no-ci</gitPushOptions> -->
  </configuration>
</plugin>

2. 如果插件配置没问题，可以手动执行git tag v0.0.2 && git push origin v0.0.2测试，看看GitLab是否生成了对应的标签流水线。

四、检查GitLab项目的流水线设置 #

进入你的GitLab项目，依次点击Settings > CI/CD > General pipelines，确保Tag pipelines选项是开启的（默认是开启的，但如果被误关了，标签推送不会触发流水线）。

验证效果 #

修改配置后，用Maven Release插件生成标签并推送，或者手动命令行推送符合规则的标签，然后去GitLab的Pipelines页面查看，应该能看到对应的标签流水线，里面的deploy-prep Job会处于待手动触发的状态。

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