一个项目同时使用mybatis 与mybatis - plus

### 同时集成和使用 MyBatis 与 MyBatis-Plus 的可行性及最佳实践 #### 1. **MyBatis 和 MyBatis-Plus 的关系** MyBatis-Plus 是 MyBatis 的增强工具集，它在保留 MyBatis 核心功能的基础上提供了更多便捷的功能，例如通用 CRUD、分页插件以及代码生成器等。理论上，MyBatis-Plus 并不会完全取代 MyBatis，而是作为其补充[^1]。 这意味着在同一项目中同时引入两者是可行的，但在实际应用过程中需要注意一些兼容性问题。 --- #### 2. **依赖冲突与版本管理** 为了确保两者的正常工作，需注意以下几点： - 添加 MyBatis-Plus 依赖的同时应移除可能存在的旧版 MyBatis 依赖，防止因版本冲突而导致运行错误。 ```xml <dependency> <groupId>com.baomidou</groupId> <artifactId>mybatis-plus-boot-starter</artifactId> <version>3.5.1</version> <!-- 版本号根据实际情况调整 --> </dependency> ``` - 若某些模块仍需单独使用原生 MyBatis 功能，则可以通过自定义 Mapper 接口继承 `org.apache.ibatis.annotations.Mapper` 而非 `com.baomidou.mybatisplus.core.mapper.BaseMapper` 来区分不同类型的 DAO 层实现[^4]。 --- #### 3. **配置分离** 为了避免混淆，建议将 MyBatis 和 MyBatis-Plus 的相关配置分开管理。例如，在 Spring Boot 配置文件中分别指定各自的扫描路径： ```yaml # MyBatis 配置 mybatis: mapper-locations: classpath:mapper/mybatis/*.xml type-aliases-package: com.example.domain.mybatis # MyBatis-Plus 配置 mybatis-plus: mapper-locations: classpath:mapper/mybatis-plus/*.xml type-aliases-package: com.example.domain.myplus ``` 这样可以清晰地区分传统 MyBatis 映射文件与 MyBatis-Plus 自动生成的内容[^1]。 --- #### 4. **事务一致性** 当两个框架共存时，必须保证事务的一致性和隔离级别。通常推荐在整个项目范围内统一声明事务管理器（Transaction Manager），并通过 AOP 或者注解形式控制具体方法的行为。 示例： ```java @Service public class UserService { @Autowired private UserMapper userMapper; // 原生 MyBatis Mapper @Autowired private PlusUserMapper plusUserMapper; // MyBatis-Plus Mapper @Transactional(rollbackFor = Exception.class) public void saveUser(User user) { try { userMapper.insert(user); plusUserMapper.insert(user); } catch (Exception e) { throw new RuntimeException("保存失败", e); } } } ``` 此处的关键在于确保两个操作均处于同一事务上下文中[^5]。 --- #### 5. **性能优化与监控** 随着业务规模扩大，混合使用的架构可能导致查询效率下降或者缓存命中率降低等问题。为此，应当定期审查 SQL 执行计划并启用慢日志分析机制以便及时发现瓶颈所在。 另外，借助第三方工具如 Arthas 或 Pinpoint 对线上环境进行全面诊断也是不错的选择[^2]。 --- #### 6. **注意事项** 尽管技术上允许同时部署这两种解决方案，但从长远来看并不提倡这样做。原因如下： - 维护成本增加：团队成员需要熟悉两种风格迥异的技术栈； - 学习曲线陡峭：新人入职后难以快速掌握全部知识点； - 升级困难：未来一旦决定全面切换到某一方则面临巨大改动压力； 因此除非确实存在无法规避的历史遗留因素外，一般还是鼓励尽早完成向单一方向过渡的过程[^3]。 ---