Spring Boot 项目中 Mvn Test 单元测试识别和运行问题解决指南

后端

2023-12-16 00:43:11

Mvn Test 无法运行 Spring Boot 单元测试：深入诊断和解决

什么是 Spring Boot 单元测试？

Spring Boot 单元测试是验证应用程序特定组件功能的自动化测试。它通常通过 Mockito、JUnit 和 AssertJ 等库来模拟外部依赖并断言预期行为。

为何 Mvn Test 可能无法运行单元测试？

导致 Mvn Test 无法运行 Spring Boot 单元测试的最常见问题是：

1. 测试类与 JUnit 不兼容：

Spring Boot 2.x 及更高版本默认使用 JUnit 5。如果你的测试类使用 JUnit 4，则需要升级或配置 Maven 以使用 JUnit 4。

2. 测试类放置不当：

测试类应位于 src/test/java 包中。如果放置在其他位置，Maven 将无法识别它们。

3. 测试类命名不规范：

测试类应以 "Test" 或 "Spec" 结尾。遵循此命名约定对于 Maven 至关重要。

4. 缺少 Maven Surefire 插件：

Maven Surefire 插件负责运行单元测试。确保已在 pom.xml 文件中配置此插件。

5. 未导入必要的依赖项：

单元测试需要特定的依赖项，例如 JUnit、Mockito 和 AssertJ。确保已在 pom.xml 文件中声明这些依赖项。

解决方法

1. 升级测试类到 JUnit 5：

在测试类中，将 JUnit 4 注解替换为等效的 JUnit 5 注解。例如，将 @RunWith(JUnit4.class) 替换为 @ExtendWith(JUnitPlatformExtension.class)。

2. 配置 Maven 以使用 JUnit 4：

在 pom.xml 文件中添加以下依赖项：

<dependency>
  <groupId>org.junit.vintage</groupId>
  <artifactId>junit-vintage-engine</artifactId>
  <version>5.9.0</version>
  <scope>test</scope>
</dependency>

<dependency>
  <groupId>junit</groupId>
  <artifactId>junit</artifactId>
  <version>4.13.2</version>
  <scope>test</scope>
</dependency>

3. 将测试类移动到正确的包：

将所有测试类移动到 src/test/java 包。

4. 确保已配置 Maven Surefire 插件：

在 pom.xml 文件中检查以下配置：

<plugin>
  <groupId>org.apache.maven.plugins</groupId>
  <artifactId>maven-surefire-plugin</artifactId>
  <version>3.0.0-M7</version>
  <configuration>
    <skipTests>false</skipTests>
  </configuration>
</plugin>

5. 导入必要的依赖项：

在 pom.xml 文件中添加以下依赖项：

<dependency>
  <groupId>junit</groupId>
  <artifactId>junit</artifactId>
  <version>5.9.1</version>
  <scope>test</scope>
</dependency>

<dependency>
  <groupId>org.mockito</groupId>
  <artifactId>mockito-core</artifactId>
  <version>4.8.1</version>
  <scope>test</scope>
</dependency>

<dependency>
  <groupId>org.assertj</groupId>
  <artifactId>assertj-core</artifactId>
  <version>3.23.1</version>
  <scope>test</scope>
</dependency>