Maven项目JUnit依赖已配置但运行测试报错：package org.junit.jupiter.api不存在

可能的原因及解决步骤： #

1. 补充依赖作用域与运行引擎依赖 #

当前junit-jupiter-api依赖未指定测试作用域，且缺少测试运行必需的引擎依赖。修改pom.xml如下：

<dependencies>
    <dependency>
        <groupId>org.junit.jupiter</groupId>
        <artifactId>junit-jupiter-api</artifactId>
        <version>5.7.0</version>
        <scope>test</scope> <!-- 指定仅测试阶段生效 -->
    </dependency>
    <!-- 添加测试运行引擎，否则测试无法正常执行 -->
    <dependency>
        <groupId>org.junit.jupiter</groupId>
        <artifactId>junit-jupiter-engine</artifactId>
        <version>5.7.0</version>
        <scope>test</scope>
    </dependency>
</dependencies>

2. 确认测试类存放路径 #

确保测试类位于Maven默认的测试目录src/test/java下，而非src/main/java。主代码目录不会加载测试作用域的依赖。

3. 清理并重建项目 #

执行Maven命令强制清理缓存、重新下载依赖并构建：

mvn clean install -U

4. 修复IDE同步问题 #

如果使用IDE运行测试：

• IntelliJ IDEA：点击右侧Maven面板的「Reload All Maven Projects」，或执行「File → Invalidate Caches... → Invalidate and Restart」
• Eclipse：右键项目 →「Maven → Update Project...」，勾选「Force Update of Snapshots/Releases」后更新

5. 检查Maven版本兼容性 #

JUnit 5.7.0要求Maven版本≥3.3.9，执行mvn -v查看版本，若过低请升级Maven。

内容的提问来源于stack exchange，提问作者Anna-Ha