oracle批量插入必须用insert all,mybatis原生foreach拼多条insert会退化为单条执行;需用包裹并${}拼接,严格控制字段顺序、类型及空值处理,单批≤1000行且手动事务管理。

Oracle批量插入必须用INSERT ALL或FORALL,MyBatis原生foreach会退化为单条执行
Java 11 + MyBatis默认走JDBC PreparedStatement,对Oracle而言,<foreach></foreach>生成多条INSERT INTO ... VALUES (...)语句时,Oracle JDBC驱动不会自动批处理——每条都单独提交,性能极差。真实批量必须依赖Oracle特有语法或JDBC的addBatch()机制,但后者需显式配置且受驱动版本限制。
- Oracle 12c+ 推荐用
INSERT ALL(单次解析、一次提交),MyBatis可直接拼装 - 若用JDBC批处理,必须设置
allowMultiQueries=true(不推荐,Oracle官方不保证兼容性)且驱动版本≥19.3 - MyBatis的
useGeneratedKeys在Oracle批量中基本失效,RETURNING子句无法与INSERT ALL共用
INSERT ALL写法要绕开MyBatis的SQL校验和参数绑定陷阱
MyBatis默认把INSERT ALL当普通SQL解析,遇到INTO关键字会报错“Parameter index out of range”。必须用<script></script>包裹并手动拼接值,同时禁用预编译参数绑定。
- 在Mapper XML中用
<script></script>标签,内部用${item.field}(不是#{item.field})拼接,避免JDBC参数占位符干扰 - 每条
INTO子句的字段顺序、类型必须严格一致,否则Oracle报ORA-00913: too many values - 批量大小建议≤1000行(Oracle单次
INSERT ALL上限约2000,但受内存和UNDO影响)
<insert id="batchInsert" parametertype="java.util.List"><script>
INSERT ALL
<foreach collection="list" item="item" separator=" ">
INTO user_table (id, name, age) VALUES (${item.id}, '${item.name}', ${item.age})
SELECT 1 FROM DUAL
</script></insert>
Java 11里要关掉JDBC的自动提交并手动控制事务边界
MyBatis默认每个SqlSession对应一个事务,但INSERT ALL本质是单条SQL,如果列表过大或中间出错,靠MyBatis默认回滚可能不彻底——Oracle的INSERT ALL是原子操作,要么全成要么全败,但异常堆栈可能掩盖真实错误位置。
- 用
SqlSession sqlSession = sqlSessionFactory.openSession(ExecutorType.BATCH)显式启用批模式(虽不改变SQL结构,但能统一事务管理) - 手动
sqlSession.commit()前检查返回值:MyBatis对INSERT ALL返回的是1(成功)或抛异常,不返回实际插入行数 - 捕获
org.apache.ibatis.exceptions.PersistenceException后,务必调用sqlSession.rollback(),否则连接可能卡在未提交状态
Oracle字段类型和空值处理稍有不慎就触发ORA-01400或ORA-00932
MyBatis拼INSERT ALL时,Java的null直接转成NULL字符串字面量,但Oracle对VARCHAR2列允许NULL,而NUMBER列若传''(空字符串)会被转成0,导致数据错乱;日期字段若传null拼成NULL没问题,但若拼成TO_DATE('', '...')就崩了。
- 所有
NUMBER字段用${item.field != null ? item.field : 'NULL'}显式判断,避免空字符串被隐式转换 -
DATE字段统一用TO_DATE('${item.dateStr}', 'YYYY-MM-DD HH24:MI:SS'),且确保item.dateStr非空;如为null,直接写NULL - 字符串字段若含单引号(如
O'Connor),必须提前用String.replace("'", "''")转义,否则SQL语法错误
真正麻烦的不是语法,是Oracle批量失败时错误定位难——它只报第一处错,后续数据全被跳过。上线前一定用含各种边界值的小批量数据跑通再扩量。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南











