cx_Oracle executemany批量插入Windows失败Linux正常，求原因及解决方案

这个问题我之前帮不少开发者排查过，核心是Windows环境下旧版本cx_Oracle+Python的组合在处理大批次数据时的兼容性/资源限制问题，咱们一步步来拆解：

可能的原因 #

• 旧版本cx_Oracle的Windows内存管理bug：cx_Oracle 5.3是比较老旧的版本（发布于2016年左右），它和Python 3.5在Windows平台上的内存协同处理存在缺陷——当单次executemany()的数据量过大时，客户端缓冲区会溢出，直接导致Oracle连接被强制断开，触发ORA-03114。
• Oracle客户端网络参数配置不合理：Windows上的Oracle Instant Client默认的网络超时、会话数据单元（SDU）设置偏小，大批次数据传输时，要么超时断开，要么因数据包拆分过多导致连接异常。
• Windows系统资源限制：Windows 7的虚拟内存如果设置不足，当Python进程处理20万行数据时，内存占用飙升，系统会强制回收资源，间接导致Oracle连接中断。

具体解决方案 #

1. 临时应急：降低单次批次大小 #

既然超过15万行就触发问题，直接把批次从20万降到10万甚至5万，比如：

# 原来的批次是200000，改成100000
batch_size = 100000
for i in range(0, len(data_list), batch_size):
    batch = data_list[i:i+batch_size]
    cursor.executemany("INSERT INTO your_table (col1, col2) VALUES (:1, :2)", batch)
    connection.commit()

这个方法最快见效，立刻能验证是否是批次大小导致的问题。

2. 根本解决：升级cx_Oracle和Oracle客户端 #

cx_Oracle 5.3对Python 3.5的Windows支持确实有不少坑，建议升级到cx_Oracle 7.3.0（这是支持Python 3.5的最高版本），同时把Oracle Instant Client升级到12cR2或更高版本（比如19c）。新版本修复了大量Windows平台的内存泄漏和连接稳定性问题，大批次插入的兼容性会好很多。

3. 调整Oracle客户端网络配置 #

在Windows的Oracle客户端目录下找到sqlnet.ora（如果没有就新建一个），添加以下参数：

# 设置60秒超时，避免大批次传输时超时断开
SQLNET.RECV_TIMEOUT=60
SQLNET.SEND_TIMEOUT=60
# 增大会话数据单元大小，减少数据包拆分
DEFAULT_SDU_SIZE=8192

修改后重启Python进程，让配置生效。

4. 优化Windows系统资源 #

右键“此电脑”→属性→高级系统设置→性能→设置→高级→虚拟内存，把虚拟内存的初始大小设置为物理内存的1.5倍，最大值设置为2倍，避免因内存不足导致连接异常。

5. 备选方案：分块插入+逐块提交 #

如果以上方法还是有问题，可以把数据拆成更小的块，每插入一块就提交一次，避免长时间占用连接资源：

small_batch_size = 50000
for i in range(0, len(data_list), small_batch_size):
    batch = data_list[i:i+small_batch_size]
    cursor.executemany("INSERT INTO your_table (col1, col2) VALUES (:1, :2)", batch)
    connection.commit()  # 每块插入后立即提交

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