Oracle node-oracledb 中 MERGE 语句批量执行时 dmlRowCounts 的异常行为分析

问题现象

在使用 Oracle node-oracledb 驱动程序进行批量 MERGE 操作时，当启用 batchErrors 和 dmlRowCounts 选项后，如果执行过程中遇到错误，后续成功执行的 MERGE 操作的 dmlRowCounts 值会被错误地返回为 0。这是一个在 Oracle Database 23.6 版本之前存在的服务器端问题。

技术背景

node-oracledb 是 Oracle 官方提供的 Node.js 数据库驱动程序，用于连接和操作 Oracle 数据库。它提供了 executeMany 方法用于批量执行 DML 语句，如 INSERT、UPDATE、DELETE 和 MERGE。

当配置选项设置为：

• batchErrors=true：允许在批量执行过程中遇到错误时继续处理剩余记录
• dmlRowCounts=true：返回每条记录执行影响的行数

问题复现场景

1. 创建两个测试表：主表 TEST_TABLE_NODE_DML_COUNTS 和辅助表 TEST_TABLE_AUX_NODE_DML_COUNTS，主表通过外键引用辅助表
2. 初始化数据：辅助表包含 ID 为 1 和 3 的记录，主表仅包含 ID 为 1 的记录
3. 执行批量 MERGE 操作，包含三条记录：
   • ID=1：更新主表中已存在的记录
   • ID=2：尝试插入但会失败（因为辅助表中无此 ID）
   • ID=3：插入新记录（辅助表中有此 ID）

预期与实际结果对比

预期行为：

• dmlRowCounts 应返回 [1,0,1]
  • 第一条记录：更新 1 行
  • 第二条记录：因外键约束失败，影响 0 行
  • 第三条记录：插入 1 行

实际行为：

• dmlRowCounts 返回 [1,0,0]
  • 第三条记录虽然成功插入，但仍返回 0

技术影响

这种异常行为会导致：

1. 应用程序无法准确判断哪些记录实际影响了数据库
2. 可能误导应用程序的业务逻辑判断
3. 在需要精确统计影响行数的场景下产生错误数据

解决方案

该问题已在 Oracle Database 23.6 版本中修复。对于使用早期版本的用户，建议：

1. 升级数据库到 23.6 或更高版本
2. 如果无法升级，可考虑以下变通方案：
   • 不使用 dmlRowCounts 选项，改为执行后查询确认
   • 将批量操作拆分为多个小批次执行
   • 对 MERGE 操作使用单独的 execute 调用而非批量执行

最佳实践建议

1. 在关键业务场景中，对批量操作的返回结果进行验证
2. 考虑在应用层添加额外的校验逻辑
3. 定期升级数据库和驱动程序以获取最新修复
4. 对于 MERGE 等复杂操作，进行充分的测试验证

这个问题提醒我们，在使用 ORM 或数据库驱动的高级功能时，需要充分理解其行为特性，并在生产环境部署前进行全面的功能验证。