Jenkins中Junit5的@BeforeEach/AfterEach钩子不执行问题

问题场景 #

本地IntelliJ IDE中运行JUnit5测试时，@BeforeEach、@AfterEach钩子正常执行，但在Jenkins上用相同目录、相同Maven命令 mvn test -Dtest=unittest.partner.SampleTests 运行时，测试用例能正常执行，但钩子完全没触发，无报错或警告。

排查与解决方案 #

• 检查Maven Surefire插件版本
  JUnit 5需要Maven Surefire插件2.22.0及以上版本才能正确识别@BeforeEach、@AfterEach等JUnit Jupiter注解。如果pom.xml里没指定Surefire版本，Jenkins环境默认的老版本插件可能不支持JUnit 5的钩子。

  给pom.xml添加明确的Surefire插件配置：

  <build>
      <plugins>
          <plugin>
              <groupId>org.apache.maven.plugins</groupId>
              <artifactId>maven-surefire-plugin</artifactId>
              <version>3.0.0-M7</version> <!-- 或更高稳定版本 -->
          </plugin>
      </plugins>
  </build>
  

• 确认测试类的注解与导入
  确保测试类中用的是JUnit 5的@Test注解（org.junit.jupiter.api.Test），而非JUnit 4的org.junit.Test。如果混用了JUnit 4的@Test，JUnit 5的钩子注解不会被触发。

  完整测试类示例要确保导入正确：

  import org.junit.jupiter.api.BeforeEach;
  import org.junit.jupiter.api.Test;
  
  public class SampleTests {
  
      @BeforeEach
      public void beforeEach() throws Exception {
          System.out.println("BeforeEach");
      }
  
      @Test
      public void sampleTest() {
          // 测试逻辑
      }
  }
  

• 清理Jenkins的Maven依赖缓存
  Jenkins本地仓库可能存在依赖冲突（比如同时有JUnit 4和JUnit 5的包），导致测试执行时意外使用了JUnit 4的引擎。可以在Jenkins构建步骤中先执行 mvn clean install -U 强制更新依赖，或者手动清理Jenkins节点的Maven缓存目录。

• 检查钩子方法的访问修饰符
  确保@BeforeEach、@AfterEach修饰的方法是public权限（默认就是public，但如果误改成private或protected，会导致JUnit引擎无法识别）。

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