cx_Oracle中executemany设置batcherrors=True未按预期运行问题

• 目标：通过设置batcherrors=True捕获无效行数据（某一列值为NULL的情况），并使用cursor.getbatcherrors()方法查看错误信息。
• 预期结果：无效行数据对应的错误信息会被存入getbatcherrors()返回结果中，所有合法行数据均能成功插入。
• 实际结果：getbatcherrors()返回为空，执行过程直接退出。
• 报错信息：Type error Expecting Number
• 已尝试操作：使用execute(statement, record)执行时可以得到预期的CAN NOT INSERT NULL错误提示，但因为需要批量插入数据改用executemany时，一旦遇到无效插入就会直接终止执行。

• 调用executemany时必须显式传入batcherrors=True参数，正确写法参考：
  cursor.executemany(insert_sql, params_list, batcherrors=True)
• 你遇到的Type error Expecting Number属于Oracle驱动层的前置参数类型校验错误，优先级高于数据库端的空值约束错误，不会进入batcherrors的捕获逻辑。需要先对批量插入的所有参数做基础类型校验，确保字段值类型和表结构定义完全匹配，排除驱动层面的前置报错。
• 完成类型校验后，空值约束类的数据库端错误才会被batcherrors正常捕获，执行完executemany后调用cursor.getbatcherrors()即可获取所有非法行的错误信息，参考逻辑如下：

cursor.executemany(insert_sql, type_validated_params, batcherrors=True)
errors = cursor.getbatcherrors()
if errors:
    for err in errors:
        print(f"非法行偏移量：{err.offset}，错误信息：{err.message}")
# 所有合法行已执行完成，直接提交事务即可
connection.commit()

• 若使用的是cx_Oracle驱动，需要升级到7.0及以上版本，旧版本对batcherrors的约束错误捕获存在兼容性缺陷。

内容的提问来源于stack exchange，提问作者balu MARAPATLA