Oracle批量插入必须用INSERT ALL，MyBatis原生foreach拼多条INSERT会退化为单条执行；需用<script>包裹并${}拼接，严格控制字段顺序、类型及空值处理，单批≤1000行且手动事务管理。
Oracle批量插入必须用INSERT ALL或FORALL，MyBatis原生foreach会退化为单条执行
Java 11 + MyBatis默认走JDBC PreparedStatement，对Oracle而言，<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>包裹并手动拼接值，同时禁用预编译参数绑定。
- 在Mapper XML中用
<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})
</foreach>
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('', '...')就崩了。
立即学习“Java免费学习笔记（深入）”；
- 所有
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批量失败时错误定位难——它只报第一处错，后续数据全被跳过。上线前一定用含各种边界值的小批量数据跑通再扩量。
