MyBatis-Plus 3.5.7版本中StrictMap类变更解析

背景介绍

MyBatis-Plus作为MyBatis的增强工具，在3.5.7版本中对核心类MybatisConfiguration进行了重要调整。其中移除了内部类StrictMap中的Ambiguity子类，这一变更直接影响了JRebel等热部署工具的使用体验。

问题现象

开发者在Spring Boot 3.3.0环境下使用JRebel 2024.2.2配合MyBatis-Plus 3.5.7时，会遇到一个特殊异常：Class 'com.baomidou.mybatisplus.core.MybatisConfiguration$StrictMap' could not be processed。这个异常虽然不影响应用正常运行，但会在启动时输出错误日志。

技术分析

1. StrictMap类的作用
   StrictMap是MyBatis-Plus中用于严格管理Mapper映射的专用Map实现，主要确保映射关系的唯一性和正确性。

2. Ambiguity子类的移除
   在3.5.7版本中，开发团队重构了这部分代码，移除了Ambiguity这个内部类。这一变更使得相关代码更加简洁，但同时也导致了依赖该类的热部署插件出现兼容性问题。

3. JRebel插件机制
   JRebel通过字节码增强技术实现热部署，其MyBatis-Plus插件尝试修改StrictMap类时，由于找不到已被移除的Ambiguity类而报错。

解决方案

对于遇到此问题的开发者，有以下几种处理方式：

1. 升级JRebel插件
   联系JRebel插件开发者更新适配MyBatis-Plus 3.5.7的版本。

2. 降级MyBatis-Plus
   暂时回退到3.5.7之前的版本，但这不推荐作为长期方案。

3. 忽略该警告
   由于这只是热部署工具的问题，不影响实际功能，可以选择忽略该错误。

最佳实践建议

1. 在升级MyBatis-Plus版本时，应同步检查所有相关工具链的兼容性。

2. 对于生产环境，建议先在小规模测试环境中验证新版本的稳定性。

3. 关注MyBatis-Plus的官方更新日志，了解每个版本的变更内容。

总结

MyBatis-Plus 3.5.7对StrictMap类的重构体现了框架的持续优化，虽然带来了短暂的兼容性问题，但从长远看有利于代码维护。开发者应理解这类变更背后的设计意图，并采取适当的应对措施。