如何从单体仓库触发多GitLab流水线？问题排查与优化咨询

一、流水线未触发的原因及修复方案 #

1. 核心问题：路径匹配错误 #

子配置文件中only: changes的路径存在重复前缀错误，以admin-server为例，你写的路径是：

only:
  changes:
    - "spring-petclinic-spring-petclinic-admin-server/**/*"

但实际微服务的目录是spring-petclinic-admin-server/，重复的spring-petclinic-前缀导致GitLab无法检测到对应目录的文件变更，因此不会触发任何作业。

修复方法 #

将所有子配置文件中的路径修正为对应微服务的实际目录，比如admin-server的子配置应修改为：

build:
  script:
    - ./mvnw $MAVEN_CLI_OPTS clean install -PbuildDocker
  stage: build  # 显式指定stage，避免歧义
  only:
    changes:
      - "spring-petclinic-admin-server/**/*"

test:
  script:
    - ./mvnw $MAVEN_CLI_OPTS test
  stage: test  # 显式指定stage
  only:
    changes:
      - "spring-petclinic-admin-server/**/*"

其余7个微服务的子配置同理，去掉路径中的重复前缀，确保和实际目录完全匹配。

额外检查项 #

• 确认提交的修改确实在目标微服务的目录下，比如修改spring-petclinic-admin-server/src/下的文件，而非其他无关目录。
• 检查项目流水线权限：进入GitLab项目「设置→CI/CD→流水线权限」，确保当前用户拥有触发流水线的权限。

二、无需修改代码即可触发特定微服务流水线的方案 #

1. 手动触发+自定义变量（推荐） #

通过在子配置中添加变量判断逻辑，实现手动指定运行特定微服务的作业：

步骤1：修改子配置（以admin-server为例）

build:
  script:
    - ./mvnw $MAVEN_CLI_OPTS clean install -PbuildDocker
  stage: build
  rules:
    - if: '$RUN_ADMIN_SERVER == "true"'
      when: always
    - changes:
        - "spring-petclinic-admin-server/**/*"
      when: always

test:
  script:
    - ./mvnw $MAVEN_CLI_OPTS test
  stage: test
  rules:
    - if: '$RUN_ADMIN_SERVER == "true"'
      when: always
    - changes:
        - "spring-petclinic-admin-server/**/*"
      when: always

其他微服务对应设置RUN_VISITS_SERVICE、RUN_VETS_SERVICE等变量即可。

步骤2：手动触发流水线

进入GitLab项目「CI/CD→流水线」页面，点击「运行流水线」，在「变量」区域添加键值对（如RUN_ADMIN_SERVER=true），点击「运行」即可触发admin-server的build和test作业，全程无需修改代码。

2. 作业手动触发（简化版） #

如果不想修改过多配置，可给每个微服务的作业添加when: manual规则：

build:
  script:
    - ./mvnw $MAVEN_CLI_OPTS clean install -PbuildDocker
  stage: build
  only:
    changes:
      - "spring-petclinic-admin-server/**/*"
  when: manual  # 设置为手动触发

test:
  script:
    - ./mvnw $MAVEN_CLI_OPTS test
  stage: test
  only:
    changes:
      - "spring-petclinic-admin-server/**/*"
  when: manual

这种方式下，当有代码变更时，作业会出现在流水线列表中，可手动点击运行；若无代码变更，可手动触发空流水线后再运行对应作业。

3. 替代git reset --hard的安全操作 #

测试后不想保留本地修改时，用git stash暂存修改比git reset --hard更安全：

# 暂存当前所有修改
git stash
# 需要恢复暂存的修改时
git stash pop

该操作不会删除未提交的内容，避免误删重要修改。

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