MySQL优化技巧：RewriteBatchedStatements使用指南

`rewriteBatchedStatements=true` 是解锁 MySQL 批量插入性能的关键开关，它能将 Java 中的 `addBatch()`/`executeBatch()` 从低效的“伪批量”（逐条网络请求）真正转变为高效的单条多值 INSERT 语句，大幅提升吞吐；但仅开启该参数远远不够——必须同步配置 `useServerPrepStmts=true` 和 `cachePrepStmts=true` 才能发挥最大效能，实测可使千条插入耗时从 12 秒降至 2.5 秒；同时需警惕其生效前提（仅限 PreparedStatement）、潜在陷阱（如 `maxAllowedPacket` 限制、云数据库多语句拦截、事务回滚粒度粗等），并务必通过抓包或日志验证真实 SQL 形态，避免“以为优化了，其实没生效”的常见误区。

rewriteBatchedStatements=true 是 MySQL 批量插入性能跃升的关键开关，不加它，Java 里的 addBatch() 和 executeBatch() 基本等于白写。

为什么开了 rewriteBatchedStatements 才算真批量

MySQL JDBC 驱动默认行为是“伪批量”：哪怕你调用 addBatch() 100 次，executeBatch() 仍会拆成 100 次独立的 INSERT INTO t VALUES (?) 网络请求。每条都走完整 TCP 往返、服务端 SQL 解析、日志刷盘流程。

开启 rewriteBatchedStatements=true 后，驱动在客户端直接重写语句：

• 对 INSERT：合并为 INSERT INTO t VALUES (?),(?),(?) 单条多值语句
• 对 UPDATE/DELETE：拼成 UPDATE t SET x=1 WHERE id=1; UPDATE t SET x=2 WHERE id=2;（需配合 allowMultiQueries=true）
• 仅当批大小 > 3 时才触发重写（源码硬编码阈值），太小的 batch 不值得合并

必须配齐的三个连接参数

单开 rewriteBatchedStatements=true 效果打折，容易踩内存或语法错误坑。这三项要一起上：

• rewriteBatchedStatements=true：启用客户端语句重写
• useServerPrepStmts=true：让 MySQL 服务端真正预编译，避免每次重写后都重新解析
• cachePrepStmts=true：缓存 PreparedStatement 对象，减少反复创建开销

漏掉任意一个，实测吞吐可能只提升 2–3 倍；三者齐备，1000 条 INSERT 的平均耗时可从 12s 降到 2.5s 左右（实测环境：MySQL 8.0 + Connector/J 8.0.33）。

MyBatis-Plus 的 saveBatch 为什么默认不快

MyBatis-Plus 的 saveBatch() 底层确实调用了 addBatch() 和 executeBatch()，但它无法绕过 JDBC 驱动的默认行为。也就是说：

• 没配 rewriteBatchedStatements=true → 还是逐条发 SQL
• 批大小由 batchSize 参数控制（如 saveBatch(list, 1000)），但驱动仍按自己逻辑决定是否重写
• 如果实体字段含 null 或特殊类型（如 LocalDateTime），重写后可能触发 SQLSyntaxErrorException，需确认驱动版本兼容性（8.0.29+ 更稳）

容易被忽略的边界和陷阱

这个参数不是万能银弹，几个关键点常被跳过：

• 只对 PreparedStatement 生效，Statement 不支持重写
• 重写后的 SQL 总长度受 maxAllowedPacket 限制，超长会报 Packets larger than max_allowed_packet bytes，需同步调大 MySQL 配置
• 事务内使用时，失败会回滚整批，错误定位困难；建议配合 continueBatchOnError=false（默认）并捕获 BatchUpdateException 查具体哪条出错
• 云数据库（如阿里云 RDS）部分版本默认禁用多语句，需确认 allowMultiQueries 是否被服务端策略拦截

最常被漏掉的是：以为加了参数就万事大吉，却没验证实际发送到 MySQL 的 SQL 形态——用 general_log 或代理层（如 ProxySQL）抓包看真实语句，才是唯一可信的判断方式。

今天关于《MySQL优化技巧：RewriteBatchedStatements使用指南》的内容就介绍到这里了，是不是学起来一目了然！想要了解更多关于的内容请关注golang学习网公众号！