MyBatis Spring Boot Starter 中重复类问题的分析与解决

问题背景

在 MyBatis Spring Boot Starter 项目中，开发者发现了一个值得关注的问题：mybatis-spring-boot-starter 和 mybatis-spring-boot-autoconfigure 两个模块之间存在重复类文件的问题。这种情况在 Java 项目中可能会导致类加载冲突，影响应用的稳定性。

问题现象

通过分析两个模块的 JAR 文件内容，可以清楚地看到：

• mybatis-spring-boot-autoconfigure 模块包含了所有必要的自动配置类，如 MybatisAutoConfiguration、MybatisProperties 等核心类
• mybatis-spring-boot-starter 模块本应只作为依赖聚合器，但却包含了与 autoconfigure 模块完全相同的类文件

这种重复会导致在类加载时可能出现冲突，特别是当两个模块的版本不一致时，问题会更加明显。

技术影响

在 Java 项目中，类加载器遵循"双亲委派"原则，但当同一个类被多个 JAR 文件包含时：

1. 可能导致类加载的不确定性，JVM 可能加载到非预期的类版本
2. 增加了应用的内存占用，因为相同的类会被加载多次
3. 在模块化系统(如 Java 9+)中可能导致更严重的问题

解决方案

MyBatis 团队已经在新版本(3.0.5-SNAPSHOT)中修复了这个问题。修复后的版本中：

• mybatis-spring-boot-starter 模块现在只包含极少的必要文件
• 所有自动配置实现都正确地放在了 autoconfigure 模块中
• 模块间的依赖关系更加清晰合理

最佳实践建议

对于使用 Spring Boot Starter 模式的开发者，应当注意：

1. Starter 模块应该只负责依赖管理，不包含具体实现
2. 自动配置实现应该放在单独的 autoconfigure 模块中
3. 使用 Maven 或 Gradle 时，确保依赖关系正确配置
4. 定期检查项目中的重复类问题，可以使用工具如 mvn dependency:analyze

总结

MyBatis Spring Boot Starter 项目及时修复了模块间重复类的问题，体现了良好的工程实践。这个问题也提醒我们，在构建类似的 Starter 项目时，需要严格区分依赖管理和具体实现，遵循 Spring Boot 的模块化设计原则，才能确保项目的稳定性和可维护性。