如何修复SpringBoot项目中"java: package org.junit.jupiter.api does not exist"错误

这个错误的核心原因是项目未引入JUnit 5（Jupiter）相关依赖，导致编译器无法找到对应的包和类。以下是针对不同构建工具的修复方案：

Maven项目修复 #

打开项目根目录下的pom.xml，确保已添加Spring Boot测试Starter依赖（该依赖会自动包含JUnit Jupiter所需的所有组件）：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-test</artifactId>
    <scope>test</scope>
</dependency>

添加完成后，执行mvn clean install命令刷新项目依赖，或者在IDE中点击"Reload All Maven Projects"按钮同步依赖。

Gradle项目修复 #

打开项目的build.gradle（Groovy语法）或build.gradle.kts（Kotlin语法）文件，添加测试依赖：

Groovy语法 #

dependencies {
    testImplementation 'org.springframework.boot:spring-boot-starter-test'
}

Kotlin语法 #

dependencies {
    testImplementation("org.springframework.boot:spring-boot-starter-test")
}

执行gradle build --refresh-dependencies命令刷新依赖，或在IDE中点击"Refresh Gradle Project"按钮同步。

额外检查项 #

• 确认IDE已完成依赖同步，避免因IDE缓存导致的依赖未加载问题。
• 检查依赖的作用域：Maven中的scope需为test，Gradle中需使用testImplementation，确保依赖仅在测试代码编译阶段生效，避免不必要的依赖污染。

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