### `Failed to resolve org.junit.platform:junit-platform-launcher:1.9.1` 错误全面解决方案 #### 问题概述 `Failed to resolve org.junit.platform:junit-platform-launcher:1.9.1` 是 Spring Boot 项目在运行单元测试时常见的依赖解析错误。该错误表明 Maven 无法从配置的仓库中下载指定版本的 JUnit 平台启动器依赖 [ref_1]。 #### 核心解决方案对比 | 解决方案 | 适用场景 | 操作复杂度 | 解决效果 | |---------|---------|-----------|---------| | 添加显式依赖 | 依赖缺失或版本冲突 | 低 | 立即生效 | | 检查 Maven 配置 | 网络或仓库配置问题 | 中 | 根本解决 | | 升级开发工具 | IDE 版本过旧 | 高 | 长期稳定 | | 依赖排除调整 | 依赖传递冲突 | 中 | 精准修复 | #### 具体解决方案 ##### 1. 添加显式依赖声明 在 `pom.xml` 文件中手动添加 `junit-platform-launcher` 依赖是最直接的解决方案： ```xml <dependency> <groupId>org.junit.platform</groupId> <artifactId>junit-platform-launcher</artifactId> <version>1.9.1</version> <scope>test</scope> </dependency> ``` **关键说明**： - `scope` 设置为 `test` 确保依赖仅在测试阶段使用 - 版本号 `1.9.1` 需与项目中其他 JUnit 依赖版本保持一致 [ref_2] ##### 2. 完整 JUnit 5 依赖配置 为确保 JUnit 5 各组件版本兼容性，建议配置完整的测试依赖： ```xml <properties> <junit-platform.version>1.9.1</junit-platform.version> </properties> <dependencies> <dependency> <groupId>org.junit.platform</groupId> <artifactId>junit-platform-launcher</artifactId> <version>${junit-platform.version}</version> <scope>test</scope> </dependency> <dependency> <groupId>org.junit.jupiter</groupId> <artifactId>junit-jupiter-engine</artifactId> <version>5.9.1</version> <scope>test</scope> </dependency> </dependencies> ``` ##### 3. Maven 配置检查与优化 网络问题或仓库配置错误是导致依赖解析失败的常见原因 [ref_4]。 **检查 `settings.xml` 配置**： ```xml <mirror> <id>aliyunmaven</id> <mirrorOf>*</mirrorOf> <name>阿里云公共仓库</name> <url>https://maven.aliyun.com/repository/public</url> </mirror> ``` **网络问题排查步骤**： 1. 执行 `mvn clean compile -U` 强制更新依赖 2. 检查网络连接和代理设置 3. 尝试切换网络环境测试 [ref_1] ##### 4. IDE 兼容性处理 IntelliJ IDEA 版本与 JUnit 版本不兼容可能导致此问题 [ref_2]。 **解决方案**： - 升级 IntelliJ IDEA 到 2020.x 或更高版本 - 在 IDEA 中重新导入 Maven 项目：`File → Reimport All Maven Projects` - 清理 IDE 缓存：`File → Invalidate Caches / Restart` ##### 5. 依赖冲突排除 当存在依赖传递冲突时，需要进行排除处理 [ref_3]： ```xml <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-test</artifactId> <scope>test</scope> <exclusions> <exclusion> <groupId>org.junit.vintage</groupId> <artifactId>junit-vintage-engine</artifactId> </exclusion> </exclusions> </dependency> ``` #### 故障排除流程 ```bash # 1. 清理本地仓库缓存 mvn dependency:purge-local-repository # 2. 强制下载所有依赖 mvn clean compile -U # 3. 检查依赖树 mvn dependency:tree -Dverbose # 4. 验证测试执行 mvn clean test ``` #### 预防措施 1. **版本统一管理**：在 `properties` 中统一定义 JUnit 相关依赖版本 2. **定期更新依赖**：保持开发工具和依赖库的及时更新 3. **CI/CD 环境一致性**：确保开发、测试、生产环境的依赖配置一致 通过上述综合解决方案，可以彻底解决 `Failed to resolve org.junit.platform:junit-platform-launcher:1.9.1` 错误，并建立稳定的测试环境配置 [ref_5][ref_6]。