在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文件中，找到
org.hamcrest hamcrest 2.2 test
依赖说明：
酷纬企业网站管理系统Kuwebs是酷纬信息开发的为企业网站提供解决方案而开发的营销型网站系统。在线留言模块、常见问题模块、友情链接模块。前台采用DIV+CSS，遵循SEO标准。 1.支持中文、英文两种版本，后台可以在不同的环境下编辑中英文。 3.程序和界面分离，提供通用的PHP标准语法字段供前台调用，可以为不同的页面设置不同的风格。 5.支持google地图生成、自定义标题、自定义关键词、自定义描
- 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()方法，使您的测试代码更加清晰和富有表现力。
