GitLab CI流水线中Maven执行测试时JUnit 5的@Disabled注解测试未被跳过导致失败

我太懂这种本地正常、CI拉胯的糟心情况了——明明本地跑mvn test能乖乖跳过标记@Disabled的测试，到GitLab CI里这些未实现功能的测试却硬被执行，还导致流水线失败，调了--fail-at-end也没改善。咱们一步步排查解决：

1. 给Surefire插件明确指定JUnit 5测试引擎 #

Spring Boot 3.x默认用JUnit 5，但Maven Surefire插件在某些环境下（比如CI镜像）需要明确绑定JUnit Platform提供者，才能正确识别@Disabled注解。你可以修改pom.xml里的插件配置：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-surefire-plugin</artifactId>
    <version>3.1.2</version>
    <dependencies>
        <!-- 强制使用JUnit 5的测试执行引擎 -->
        <dependency>
            <groupId>org.apache.maven.surefire</groupId>
            <artifactId>surefire-junit-platform</artifactId>
            <version>3.1.2</version>
        </dependency>
    </dependencies>
</plugin>

这样能确保Surefire用JUnit 5的规则来处理测试，自然会跳过标记@Disabled的用例。

2. 清理CI的Maven缓存，排除旧依赖干扰 #

你配置了Maven仓库缓存，有可能缓存里的旧依赖（比如之前残留的JUnit 4相关依赖）导致Surefire行为异常。可以临时调整CI脚本，先刷新依赖再跑测试：

Test job:
  stage: test
  script:
    - 'mvn $MAVEN_CLI_OPTS clean install -DskipTests'
    - 'mvn $MAVEN_CLI_OPTS test'
  allow_failure: true

如果这样能解决问题，说明是缓存的锅，清理CI的缓存后再恢复原配置就行。

3. 确认测试注解的正确性 #

再核对下测试类里的注解：必须是JUnit 5的org.junit.jupiter.api.Disabled，而不是JUnit 4的org.junit.Ignore。要是不小心用了后者，JUnit 5的引擎根本不会识别，测试自然会被执行。

4. 对齐本地和CI的Maven/JDK版本 #

你CI用的是maven:3-openjdk-17镜像，本地执行mvn -v和java -version看看版本是否一致。不同版本的Maven或JDK偶尔会出现行为差异，对齐版本能排除这类问题。

试试上面的方法，应该能搞定CI里@Disabled测试乱跑的问题。

备注：内容来源于stack exchange，提问作者Ilya Zhukau