迁移JUnit5+Mockito后Jenkins执行测试大量失败求助

1. 构建环境类加载差异 #

• Jenkins的Gradle执行可能复用JVM进程，导致Mockito静态Mock状态残留，而本地默认可能为每个测试类fork新进程。检查build.gradle的test任务配置，强制每个测试类启动新JVM：

  test {
      forkEvery = 1
  }
  

• 禁用Jenkins的增量构建，执行./gradlew clean test清除所有构建缓存，避免旧代理类残留。

2. Mockito Inline字节码增强兼容性 #

• Jenkins环境可能启用了Jacoco、SonarQube等字节码增强工具，与Mockito Inline的字节码操作冲突。临时禁用代码覆盖率工具，验证测试是否恢复正常。
• 对比本地与Jenkins的JVM参数，确保Jenkins包含Mockito Inline所需的权限参数，比如--add-opens java.base/java.lang=ALL-UNNAMED。

3. 测试执行顺序与状态污染 #

• Jenkins的Gradle可能并行执行测试，导致静态Mock状态跨测试类污染。先禁用并行测试排查：

  test {
      maxParallelForks = 1
  }
  

• 在每个测试类添加@AfterEach方法，显式清理Mock状态：

  @AfterEach
  void tearDown() {
      Mockito.clearAllCaches();
      // 针对使用静态Mock的类，显式重置
      Mockito.resetStatic(YourStaticClass.class);
  }
  

4. UnfinishedMockingSessionException专项排查 #

• 所有静态Mock必须放在try-with-resources块中，确保Mock会话自动关闭：

  try (MockedStatic<YourStaticClass> mockedStatic = Mockito.mockStatic(YourStaticClass.class)) {
      mockedStatic.when(YourStaticClass::yourMethod).thenReturn(expectedValue);
      // 测试逻辑
  }
  

• 查看Jenkins日志中第一个抛出该异常的测试，检查其Mock代码是否存在条件分支导致when()调用未完成的情况。

5. 依赖版本与冲突验证 #

• 在本地和Jenkins分别执行./gradlew dependencies，对比mockito-core、mockito-inline、junit-jupiter等核心依赖的实际版本是否完全一致。
• 强制锁定核心依赖版本，排除传递依赖冲突：

  configurations.all {
      resolutionStrategy {
          force 'org.mockito:mockito-core:4.5.1'
          force 'org.mockito:mockito-inline:4.5.1'
          force 'org.junit.jupiter:junit-jupiter-api:5.8.2'
      }
  }
  

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