怎么解决MyBatis开发中XML修改后需要重启的问题_MyBatis-Plus热加载插件配置-java教程-PHP中文网

MyBatis XML 修改不生效主因是未启用热加载，需引入 mybatis-spring-boot-devtools 插件并配置 enable: true，确保 XML 路径匹配、文件名与接口名一致，且避免手动定义 SqlSessionFactory 或跨文件 include。

怎么解决mybatis开发中xml修改后需要重启的问题_mybatis-plus热加载插件配置

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 重建会失败，导致服务短暂不可用——这点很容易被忽略，上线前务必在本地验证异常场景下的恢复行为。