Python 3.8+cx_Oracle/python-oracledb executemany batcherrors=True失效问题

核心原因：batcherrors仅处理行级错误，不覆盖语句级语法错误 #

你遇到的ORA-00984（列名无效）属于SQL语句编译阶段的语法错误，Oracle在解析SQL时就会直接抛出这类错误，根本没进入批量执行数据行的环节。而batcherrors=True的设计目的是捕获批量执行过程中单个数据行的错误（比如某行数据违反主键约束、字段类型不匹配），完全无法处理语句本身的语法问题，所以此时调用getbatcherrors()返回空列表是正常行为。

具体修复步骤 #

1. 修正SQL语句的语法错误

   • RANK是Oracle的保留关键字，作为列名必须用双引号包裹，否则会被识别为关键字触发ORA-00984，修改后的SQL片段：

     INSERT INTO %s (NAME, AGE, ADDRESS, "RANK")
     VALUES (:1, :2, :3, :4)
     

   • 代码中的FIVE如果是字符串常量，需要添加单引号（比如'FIVE'）；如果是要传入的参数，需改为占位符:4，并在record_list对应位置传入对应值。

2. 明确batcherrors的适用场景

   • 只有当SQL语句本身合法，执行时部分数据行因自身问题（比如字段值过长、违反唯一约束）报错时，batcherrors才会生效。此时不会直接抛出异常，而是可以通过getbatcherrors()获取所有行级错误的详情。

3. 代码优化建议

   • 表名拼接存在SQL注入风险，建议提前校验表名合法性，或通过白名单方式限制可操作的表；
   • 异常处理中增加cursor是否为空的判断，避免空指针问题；
   • 修正后的示例代码：

     import oracledb as cx_Oracle
     
     def get_db_connection():
         # 省略连接逻辑
         dsn_str = cx_Oracle.makedsn(db_host, db_port, service_name=db_service_name)
         conn = cx_Oracle.connect(user=serv_username, password=serv_password, dsn=dsn_str)
         return conn
         
     def insert_records(record_list):
         conn = None
         cursor = None
         try:
             # 用双引号包裹关键字列名，将FIVE改为占位符:4
             query = ''' INSERT INTO %s (NAME, AGE, ADDRESS, "RANK")
                          VALUES (:1, :2, :3, :4) ''' % table_name
             conn = get_db_connection()
             cursor = conn.cursor()
             
             cursor.executemany(query, record_list, batcherrors=True)
             
             errors = cursor.getbatcherrors()
             if errors:
                 for error in errors:
                     print(f"第 {error['offset']} 行出错: {error['message']}")
             else:
                 print("所有数据插入成功")
             
             conn.commit()
             
         except cx_Oracle.DatabaseError as e:
             print(f"语句级错误: {e}")
             if cursor:
                 errors = cursor.getbatcherrors()
                 for error in errors:
                     print(f"行级错误: 第 {error['offset']} 行 - {error['message']}")
         finally:
             if cursor:
                 cursor.close()
             if conn:
                 conn.close()
     

内容的提问来源于stack exchange，提问作者Rohit Mewar