SQL Server MERGE语句WHEN NOT MATCHED执行异常排查

• 校验动态SQL生成的MERGE匹配条件
  动态拼接SQL时极易出现字段名拼写错误、条件逻辑偏差或类型隐式转换问题。比如误将匹配条件写成ON Source.requestMaterialId = Target.RequestMaterialId（目标表字段名大小写/拼写错误），或是拼接时未正确处理字段的方括号/引号，导致匹配条件失效，SQL Server判定无匹配记录从而触发插入。建议通过PRINT @MergeSql输出动态生成的完整MERGE语句，直接执行该语句验证是否仍触发插入，同时对比模拟环境的正确语句找差异。

• 检查临时表FieldCombinations的隐性类型/值问题
  即使表面字段类型一致，动态创建的临时表可能存在隐性差异：比如源表requestMaterialId为INT，但动态建表时误设为VARCHAR，值123与'123'会因隐式转换导致匹配失败；或是字段长度、精度不一致（如DECIMAL(18,2)与DECIMAL(18,0)）。可通过sp_help 'FieldCombinations'查看临时表结构，与目标表id字段做精准对比；同时执行SELECT * FROM FieldCombinations fc JOIN TargetTable t ON fc.requestMaterialId = t.id，验证源数据是否真能匹配到目标记录。

• 排查MERGE语句的附加过滤逻辑
  若WHEN MATCHED后添加了额外过滤条件（如WHEN MATCHED AND Status = 1），当该条件不满足时，SQL Server会跳过更新，但不会直接触发插入——核心问题仍可能是ON子句的匹配条件未生效。另外需确认源数据的requestMaterialId是否为NULL：目标表id作为标识列不可能为NULL，NULL与任何值都不匹配，会直接触发插入逻辑。

• 核对动态SQL的执行上下文差异
  模拟环境与生产环境的执行上下文可能存在区别：

  • 临时表作用域：确保创建FieldCombinations与执行MERGE在同一动态SQL批处理中，避免临时表数据未正确加载；
  • 数据库排序规则：若源临时表与目标表排序规则不同，字符串类型字段匹配时可能出现不匹配，导致触发插入。

• 排查并发或数据变更影响
  MERGE执行过程中，若其他会话修改了目标表的匹配记录（如删除对应行），会导致MERGE时无匹配从而触发插入。可在MERGE前后添加日志记录（如插入日志表留存源数据与目标表当时的匹配情况），或用事务包裹MERGE并添加UPDLOCK, HOLDLOCK提示，防止并发修改干扰匹配逻辑。

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