MyBatisXML热更新不重启方案

MyBatis XML修改后不生效？根本原因在于热加载未正确启用——Spring Boot默认不支持XML热重载，尤其在MyBatis-Plus场景下更需依赖第三方插件（如mybatis-spring-boot-devtools）并精准配置：不仅要引入匹配版本的插件、开启`devtools.reload.enable: true`，还需确保XML路径规范、文件名与Mapper接口严格一致，同时避开手动定义SqlSessionFactory、跨文件include等常见陷阱；而MyBatis-Plus 3.5+内置热加载虽存在，却稳定性差、不支持动态SQL变更且易引发事务异常，强烈推荐优先采用经过验证的插件方案，并务必在本地充分测试异常恢复能力，避免上线后因XML解析失败导致服务短暂中断。

MyBatis XML 文件修改后不生效，是不是没开热加载？

不是所有 MyBatis 项目默认支持 XML 热加载，尤其在 Spring Boot + MyBatis-Plus 场景下，mybatis-plus 本身不内置 XML 热重载能力，靠的是底层 MyBatis 的 configuration.setEnvironment() 重建逻辑或第三方插件触发刷新。常见现象是改了 xxxMapper.xml，接口返回旧 SQL，日志里也看不到新语句——这基本说明 XML 没被重新解析。

devtools + mybatis-spring-boot-devtools 插件怎么配才真正生效？

Spring Boot DevTools 只负责类路径资源变更通知，它不会自动告诉 MyBatis “XML 更新了”。必须配合 mybatis-spring-boot-devtools（注意不是官方 mybatis-spring-boot-starter 自带的）才能监听 *.xml 并触发 SqlSessionFactory 刷新。关键点在于版本对齐和配置开关：

• 用 Maven 引入 com.github.xiaoymin:mybatis-spring-boot-devtools，版本需匹配你的 mybatis-plus-boot-starter（例如 3.5.x 对应 devtools 1.0.x）
• 在 application.yml 中显式开启：

  mybatis-plus:
    devtools:
      reload:
        enable: true

• 确保 XML 文件放在 src/main/resources/mapper/ 或你配置的 mybatis-plus.mapper-locations 路径下，否则插件找不到文件
• IDE 中关闭 “Build project automatically”（IntelliJ 默认关），改用 Ctrl+Shift+F9 手动编译，否则 DevTools 不触发资源变更事件

为什么加了插件还是不刷新？常见卡点在哪？

最常踩的坑不是配置错，而是环境干扰：

• SqlSessionFactory 被声明为 @Bean 且用了自定义 Configuration 实例：插件只接管 Spring 容器托管的默认工厂，手动 new 出来的不响应
• 用了 @MapperScan 扫描注解式 Mapper，但 XML 文件名和接口名不严格匹配（如 UserMapper.java 对应 UserMapper.xml），插件无法关联映射关系
• 启动时控制台没打印 [MybatisDevTools] Watching for changes in mapper XML files... —— 说明插件根本没加载，检查是否被 Maven optional=true 或依赖冲突屏蔽
• XML 里写了 ，但被引用的 片段在另一个 XML 文件里：插件目前不追踪跨文件依赖，改了被 include 的文件不会触发主文件重载

MyBatis-Plus 3.5+ 内置的 XML 热加载要不要用？

3.5.0+ 确实新增了 mybatis-plus.configuration.devtool-reload-enabled=true 开关，但它依赖 MyBatis 原生的 XMLMapperBuilder 重解析机制，实际表现不稳定：

• 仅支持单个 XML 文件内变更，不处理 、 或动态 SQL 标签内容变化
• 重启 SqlSession 时可能引发事务中已打开 session 的状态不一致，出现 Cannot commit when auto commit is enabled 类错误
• 和 DevTools 插件共存时容易冲突，建议二选一，优先用插件方案

复杂点在于：XML 热加载本质是“局部刷新”，但 MyBatis 的映射注册是全局的；一旦某个 XML 解析失败，整个 SqlSessionFactory 重建会失败，导致服务短暂不可用——这点很容易被忽略，上线前务必在本地验证异常场景下的恢复行为。

终于介绍完啦！小伙伴们，这篇关于《MyBatisXML热更新不重启方案》的介绍应该让你收获多多了吧！欢迎大家收藏或分享给更多需要学习的朋友吧~golang学习网公众号也会发布文章相关知识，快来关注吧！