MyBatis-Plus批量插入返回值问题解析与解决方案

问题背景

在使用MyBatis-Plus 3.5.7版本时，开发者发现Db.saveBatch()方法在执行批量插入操作时，虽然数据成功插入数据库，但方法始终返回false。这个问题在Java21 + MySQL8.0.32 + SpringBoot3.2.6环境下尤为明显。

问题原因分析

经过深入分析，发现问题的根源在于MySQL JDBC驱动参数rewriteBatchedStatements=true与MyBatis-Plus批量处理机制的兼容性问题。

1. 返回值判断逻辑：MyBatis-Plus通过检查批处理结果的更新计数来判断操作是否成功，当计数大于0时返回true。

2. MySQL驱动行为：当启用rewriteBatchedStatements参数时，MySQL JDBC驱动会重写批量语句，返回的更新计数为SUCCESS_NO_INFO(-2)，表示语句执行成功但没有可用的受影响行数计数。

3. 版本差异：在MyBatis-Plus 3.5.6版本中，判断逻辑有所不同，能够正确处理这种情况，但在3.5.7版本中修改了判断逻辑，导致与重写批处理语句不兼容。

解决方案

针对这个问题，有以下几种解决方案：

1. 移除rewriteBatchedStatements参数： 在数据库连接配置中移除rewriteBatchedStatements=true参数，这是最简单直接的解决方案。

2. 忽略返回值： 如果业务场景不关心具体的批量结果，可以直接使用BaseMapper的insert方法，不检查返回值。

3. 自定义批量插入逻辑： 对于需要精确控制批量插入行为的场景，可以自行实现批量插入逻辑，避免依赖框架的返回值判断。

最佳实践建议

1. 版本选择：如果项目必须使用rewriteBatchedStatements参数，可以考虑暂时使用MyBatis-Plus 3.5.6版本。

2. 返回值处理：在业务代码中，不要过度依赖Db.saveBatch()的返回值来判断操作是否成功，可以通过捕获异常或查询数据库来确认数据是否插入成功。

3. 配置审查：在使用批量操作时，应该仔细审查JDBC连接配置，确保各项参数与ORM框架版本兼容。

技术原理延伸

MySQL的rewriteBatchedStatements参数会将多个INSERT语句重写为单个多值INSERT语句，这虽然提高了性能，但改变了JDBC批处理的原始语义。MyBatis-Plus的批量操作在底层依赖于JDBC的批处理API，当驱动重写语句后，框架无法获取准确的更新计数，导致返回值判断失效。

理解这一机制有助于开发者在遇到类似问题时快速定位原因，并根据实际业务需求选择合适的解决方案。