在junit 5测试中遇到`assertthat()`方法找不到的问题，通常是由于hamcrest库未被显式引入。junit 5移除了对hamcrest的内置依赖，因此若需使用其强大的断言功能，开发者需要手动添加hamcrest作为单独的测试依赖。本文将详细指导如何正确配置，确保`assertthat()`在您的spring boot junit 5项目中正常工作。
问题背景与原因分析
当您在基于Spring Boot和JUnit 5（通常是JUnit Jupiter）的项目中编写测试时，可能会遇到IntelliJ IDEA或其他IDE提示assertThat()方法无法解析的错误，即使您已经尝试引入了import static org.junit.Assert.*;或import static org.hamcrest.MatcherAssert.assertThat;。这通常发生在从JUnit 4迁移到JUnit 5，或者直接在JUnit 5环境中开始开发时。
其根本原因在于JUnit 4和JUnit 5在依赖管理上的差异。在JUnit 4中，Hamcrest库（提供了assertThat方法）是作为JUnit核心库的一个传递性依赖被自动引入的。这意味着只要您引入了JUnit 4，Hamcrest也会随之而来。然而，JUnit 5（JUnit Jupiter）采用了更模块化的设计理念，移除了对Hamcrest的内置或传递性依赖。JUnit 5旨在提供一个更轻量级的核心，允许开发者自由选择他们偏好的断言库，例如JUnit 5自带的Assertions、Hamcrest或AssertJ等。
因此，当您在JUnit 5项目中尝试使用Hamcrest的assertThat方法时，即使您已经引入了JUnit 5的相关依赖（如org.junit.jupiter:junit-jupiter-api），编译器仍然无法找到assertThat，因为它不再是JUnit 5的一部分，需要作为独立的依赖显式添加。
解决方案：引入Hamcrest依赖
要解决assertThat()方法找不到的问题，您需要手动将Hamcrest库作为测试依赖添加到您的项目构建文件中。以下是Maven项目的配置示例：
在您的pom.xml文件中，找到<dependencies>部分，并添加以下Hamcrest依赖：
<dependency>
<groupId>org.hamcrest</groupId>
<artifactId>hamcrest</artifactId>
<version>2.2</version> <!-- 推荐使用最新稳定版本 -->
<scope>test</scope>
</dependency>依赖说明：
- groupId: org.hamcrest 指明了Hamcrest库的组织ID。
- artifactId: hamcrest 指明了Hamcrest库的构件ID。
- version: 2.2 是一个常用的稳定版本。建议查阅Maven Central Repository获取最新的稳定版本。
- scope: test 表示这个依赖只在测试编译和运行时需要，不会被打包到最终的生产代码中。
添加此依赖后，请确保您的构建工具（如Maven或Gradle）重新加载项目依赖。在IntelliJ IDEA中，通常点击Maven工具窗口的“Reload All Maven Projects”按钮即可。
示例代码与正确用法
添加Hamcrest依赖后，您的测试类就可以正常使用assertThat()方法了。请确保在测试类中导入正确的静态方法：
package com.mycompany;
import static org.hamcrest.MatcherAssert.assertThat; // 引入Hamcrest的assertThat
import static org.hamcrest.Matchers.*; // 引入Hamcrest的匹配器，如is, equalTo等
// 注意：通常不需要再导入 org.junit.Assert.*;，因为Hamcrest提供了自己的assertThat
import com.mycompany.book.Book;
import com.mycompany.book.BookRepository;
import org.junit.jupiter.api.Assertions; // JUnit 5 自带的断言
import org.junit.jupiter.api.Test;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.autoconfigure.jdbc.AutoConfigureTestDatabase;
import org.springframework.boot.test.autoconfigure.orm.jpa.DataJpaTest;
import org.springframework.test.annotation.Rollback;
@DataJpaTest
@AutoConfigureTestDatabase (replace = AutoConfigureTestDatabase.Replace.NONE)
@Rollback(value = false)
public class BookRepositoryTests {
@Autowired private BookRepository repo;
@Test
public void testAddNew(){
Book book = new Book();
book.setTitle("The Divine Comedy");
book.setAuthor("Dante Alighieri");
book.setGenre("Poetry");
Book savedBook = repo.save(book);
// 使用Hamcrest的assertThat进行断言
assertThat(savedBook, is(notNullValue())); // 检查保存的图书不为空
assertThat(savedBook.getId(), greaterThan(0)); // 检查ID是否大于0
assertThat(savedBook.getTitle(), is(equalTo("The Divine Comedy"))); // 检查标题是否正确
// 也可以使用JUnit 5自带的Assertions进行断言
Assertions.assertNotNull(savedBook);
Assertions.assertTrue(savedBook.getId() > 0);
Assertions.assertEquals("Dante Alighieri", savedBook.getAuthor());
}
}在上述代码中：
- import static org.hamcrest.MatcherAssert.assertThat; 引入了Hamcrest的断言方法。
- import static org.hamcrest.Matchers.*; 引入了Hamcrest提供的各种匹配器（如is、equalTo、notNullValue、greaterThan等），这些匹配器是assertThat方法第二个参数的关键，用于构建可读性强的断言语句。
注意事项与最佳实践
- 避免混淆JUnit 4和JUnit 5依赖： 在JUnit 5项目中，请确保您使用的是JUnit Jupiter的相关依赖（如org.junit.jupiter:junit-jupiter-api、org.junit.jupiter:junit-jupiter-engine等），而不是JUnit 4的junit:junit。混用可能导致不必要的依赖冲突或行为异常。
-
选择合适的断言库：
- JUnit 5 Assertions： 对于简单的等价性、真假值、空值检查等，JUnit 5自带的org.junit.jupiter.api.Assertions通常足够且是首选。
- Hamcrest assertThat： 当您需要更灵活、表达力更强的匹配逻辑时（例如，检查集合内容、字符串模式、对象属性等），Hamcrest的assertThat结合其丰富的匹配器会非常有用。
- AssertJ： AssertJ是另一个非常流行的流式断言库，提供了极佳的可读性和丰富的断言方法链。如果您追求极致的断言表达力，AssertJ也是一个值得考虑的选择。
- 依赖版本管理： 始终使用最新稳定的依赖版本，以获取最新的功能和安全修复。对于Spring Boot项目，通常Spring Boot的父POM会管理JUnit和Hamcrest的版本，您可以依赖其默认配置，除非有特殊需求。
总结
在JUnit 5项目中，assertThat()方法不再是内置功能。为了在测试中利用Hamcrest提供的强大断言能力，您需要显式地在项目构建文件中添加Hamcrest库作为测试依赖。理解JUnit 4和JUnit 5在依赖管理上的差异，并根据项目需求选择合适的断言库，是编写高效、可维护测试的关键。通过正确配置Hamcrest依赖并引入相应的静态方法，您将能够充分利用assertThat()方法，使您的测试代码更加清晰和富有表现力。
