Maven构建带JUnit测试的Java Spring项目提示org.junit.runner不存在

核心触发原因 #

• 测试目录不规范：你给出的测试文件路径为src>test>Java>xxx，Maven默认的测试源码根目录为全小写的src/test/java，大写的Java目录不会被识别为测试源码目录，test scope的JUnit依赖不会被加载到该路径的类路径下，导致类找不到。
• 依赖冲突：你同时引入了单独的JUnit4.12依赖和spring-boot-starter-test，高版本的spring-boot-starter-test默认内置JUnit5（Jupiter），二者冲突会导致JUnit4的类被覆盖缺失。
• 本地依赖缓存损坏：Maven本地仓库中存储的JUnit4.12包下载不完整，存在类文件缺失的情况。

解决步骤 #

1. 修正测试目录命名
   将src/test/Java重命名为src/test/java，之后在IDE中将该目录标记为测试源根目录：

• IDEA操作：右键目录 → Mark Directory as → Test Sources Root
• Eclipse操作：右键目录 → Build Path → Use as Source Folder

2. 调整JUnit依赖配置
   删除你单独声明的junit:junit:4.12依赖，修改spring-boot-starter-test配置排除JUnit5，使用starter内置的JUnit4兼容包即可：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-test</artifactId>
    <scope>test</scope>
    <exclusions>
        <exclusion>
            <groupId>org.junit.jupiter</groupId>
            <artifactId>junit-jupiter</artifactId>
        </exclusion>
    </exclusions>
</dependency>

注意：不要随便移除JUnit的test scope，否则测试依赖会被打进生产jar包，增大包体积还会引入不必要的安全风险。

3. 清理缓存重新构建
   在项目根目录执行Maven命令强制更新依赖并重建项目：

mvn clean install -U

执行完成后重启IDE，重新编译项目即可解决报错。

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