Eclipse中org.junit无法解析但已添加Maven依赖的问题求助

我之前在Java 9 + Eclipse Oxygen环境下开发模块化项目时，也碰到过一模一样的问题——Maven依赖里明明有junit-4.12.jar，打开JAR包也能看到完整的类文件，但Eclipse就是识别不了org.junit相关的包。试了下面几个方案后顺利解决了，你可以按顺序试试：

• 先检查module-info.java的依赖声明
  因为是Jigsaw模块化项目，你的模块必须明确声明对JUnit的依赖。JUnit 4.12属于自动模块（没有自带module-info.class），它的自动模块名是junit，所以需要在你的主模块或者测试模块的module-info.java里添加：

  requires junit;
  

  如果你的测试代码放在单独的源文件夹（比如src/test/java）且有自己的module-info.test.java，也要确保这个文件里加上上面的声明。

• 调整Eclipse的Maven依赖与构建路径

  1. 右键项目 → Maven → Update Project...，勾选「Force Update of Snapshots/Releases」，点击OK强制刷新依赖，有时候Maven的缓存会导致Eclipse识别不到最新的依赖状态。
  2. 右键项目 → Build Path → Configure Build Path，切换到Libraries标签页：
     • 确认Maven Dependencies下的junit-4.12.jar存在；
     • 确保它被放在Modulepath而非Classpath上——Java 9+模块化项目中，只有Modulepath上的依赖才会被模块系统识别。

• 修复Eclipse的模块化项目配置缓存
  有时候Eclipse对模块化项目的配置会出现缓存问题，试试这步：
  右键项目 → Properties → Java Build Path → Modulepath，先移除junit-4.12.jar，然后从Maven Dependencies里重新把它添加到Modulepath中。
  另外也可以检查下Project Facets：右键项目 → Properties → Project Facets，确保Java版本设置为9，并且Module选项已勾选（如果有这个选项的话）。

• 清理并重建项目

  1. 点击Eclipse顶部的Project菜单 → Clean...，选择你的项目后点击OK，清理项目的编译缓存。
  2. 手动删除项目根目录下的target文件夹，然后右键项目 → Run As → Maven install，重新构建整个项目。

• 检查pom.xml里的JUnit依赖范围
  确保你的pom.xml中JUnit的依赖配置正确，通常测试依赖的scope是test：

  <dependency>
      <groupId>junit</groupId>
      <artifactId>junit</artifactId>
      <version>4.12</version>
      <scope>test</scope>
  </dependency>
  

  如果你的主代码里也用到了JUnit（不推荐），可以把scope改成compile，但要确保对应的module-info.java里已经声明了依赖。

内容的提问来源于stack exchange，提问作者Bartłomiej Zieliński