IntelliJ中Maven项目Junit依赖无法识别问题求助

排查与修复步骤 #

• 重新加载Maven依赖
  在IntelliJ右侧Maven面板点击刷新图标（🔄），或右键项目选择Maven -> Reload Project，强制IDE重新读取pom.xml并同步依赖。若依赖下载失败，可删除本地Maven仓库中org.junit.jupiter相关目录后重试，同时检查Maven镜像配置是否可用。

• 校验pom.xml依赖配置
  确保JUnit 5的依赖配置完整且正确，需包含API与测试引擎（Jupiter），示例配置如下：

  <dependencies>
      <!-- JUnit 5 API -->
      <dependency>
          <groupId>org.junit.jupiter</groupId>
          <artifactId>junit-jupiter-api</artifactId>
          <version>5.9.2</version>
          <scope>test</scope>
      </dependency>
      <!-- JUnit 5 测试引擎 -->
      <dependency>
          <groupId>org.junit.jupiter</groupId>
          <artifactId>junit-jupiter-engine</artifactId>
          <version>5.9.2</version>
          <scope>test</scope>
      </dependency>
  </dependencies>
  

  注意scope必须设为test，且两个依赖版本保持一致，避免版本冲突。

• 确认测试类目录合法性
  Maven默认测试类目录为src/test/java，你的uniTesting包需放置在此目录下。若测试类位于src/main/java，可右键对应目录选择Mark Directory as -> Test Sources Root，让IDE识别为测试资源目录，加载test scope的依赖。

• 清理重建项目
  执行Build -> Clean Project清除编译缓存，再执行Build -> Rebuild Project重新构建，解决缓存导致的依赖识别异常。

• 调整IntelliJ Maven运行配置
  打开File -> Settings -> Build, Execution, Deployment -> Build Tools -> Maven -> Runner，勾选Delegate IDE build/run actions to Maven选项，让IDE依托Maven逻辑处理依赖与构建。

• 多模块项目额外检查
  若为多模块Maven项目，需确认当前模块已正确继承父模块的JUnit依赖，或在自身pom.xml中直接声明了完整的JUnit 5依赖。

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