### 解决方案 在 Spring Boot 和 MyBatis 的测试环境中遇到 `junit-platform-launcher` 版本 1.8.2 的依赖问题时，通常是因为 Maven 或 Gradle 构建工具未能正确解析该依赖项。以下是详细的解决方案： #### 1. 检查 JUnit 平台版本兼容性 确保项目中的 JUnit 平台版本与其他相关依赖项保持一致。JUnit 5 包含三个主要模块：`jupiter`, `vintage`, 和 `platform`。如果这些模块之间的版本不匹配，则可能导致构建失败。 推荐的 JUnit 5 依赖配置如下[^2]: ```xml <dependency> <groupId>org.junit.jupiter</groupId> <artifactId>junit-jupiter-api</artifactId> <version>5.9.3</version> <scope>test</scope> </dependency> <dependency> <groupId>org.junit.jupiter</groupId> <artifactId>junit-jupiter-engine</artifactId> <version>5.9.3</version> <scope>test</scope> </dependency> <dependency> <groupId>org.junit.platform</groupId> <artifactId>junit-platform-launcher</artifactId> <version>1.9.3</version> <scope>test</scope> </dependency> ``` 注意：上述版本号应根据实际需求调整至最新稳定版。 --- #### 2. 配置资源文件路径 有时，测试类无法加载必要的 XML 文件或其他资源配置，这可能会间接引发依赖错误。可以通过修改 `pom.xml` 中的 `<build>` 节点来确保所有资源被正确打包[^4]: ```xml <build> <resources> <resource> <directory>src/main/java</directory> <includes> <include>**/*.xml</include> </includes> </resource> <resource> <directory>src/main/resources</directory> </resource> </resources> </build> ``` 此配置可帮助解决因缺少资源而导致的潜在问题。 --- #### 3. 清理并重新安装依赖 当本地仓库缓存损坏或网络连接不稳定时，Maven 可能会下载到不完整的依赖项。执行以下命令清理并强制更新依赖: ```bash mvn clean install -U ``` 此操作将清除旧的依赖缓存，并尝试从远程仓库获取最新的依赖项。 --- #### 4. 替代 vintage 引擎 某些情况下，`junit-vintage-engine` 不再适用（尤其是仅使用 JUnit 5 时），可以将其移除以减少冲突风险[^3]。如果确实不需要支持 JUnit 4 测试用例，则无需引入 `junit-vintage-engine`。 --- #### 5. 使用随机端口运行集成测试 对于涉及 Web 应用程序的测试场景，建议通过设置随机端口号避免端口占用引起的异常[^1]。可以在测试类上添加以下注解： ```java @SpringBootTest(webEnvironment = SpringBootTest.WebEnvironment.RANDOM_PORT) public class YourTestClass { // Test methods here... } ``` --- #### 6. 自定义 resultMap 处理 如果测试过程中涉及到复杂的 SQL 查询结果映射，需确认 MyBatis 的 XML 配置文件是否正确声明了 `resultMap`[^5]。例如： ```xml <resultMap id="customResultMap" type="com.example.YourEntity"> <id property="id" column="ID"/> <result property="name" column="NAME"/> <!-- Add more mappings as needed --> </resultMap> <select id="selectCustomData" resultMap="customResultMap"> SELECT ID, NAME FROM your_table WHERE condition = #{param}; </select> ``` 确保实体类字段名与数据库列名一一对应，或者显式指定映射关系。 --- ### 总结 以上方法涵盖了从依赖管理、资源配置到具体测试环境优化等多个方面的问题排查手段。若仍存在未解决问题，请进一步检查日志输出的具体错误信息以便定位根本原因。