SQL Server MERGE语句ON条件未检测到匹配引发唯一键约束冲突问题求助

嘿，看了你的问题，这个唯一键冲突的情况其实挺常见的，咱们一步步拆解分析：

首先，错误提示说明你的MERGE语句尝试插入一条已经存在于address表中的记录，但你的ON条件没检测到匹配。最可能的原因和解决方案如下：

1. 源表存在重复记录（最大概率） #

你的MERGE是把RAW_CM_Companies里的所有记录和目标表做匹配，但如果源表本身就有多条完全相同的地址行（包括NULL值完全对应），就会出现这种问题：

• 第一条源记录执行时，目标表没有匹配项，成功插入；
• 第二条相同的源记录执行时，由于MERGE的匹配逻辑是基于语句执行开始时的目标表快照（源数据是一次性读取的，此时目标表刚插入的新行还没被匹配逻辑识别到），所以会再次触发WHEN NOT MATCHED的插入逻辑，最终触发唯一键约束。

解决办法：在USING子查询中加入DISTINCT去重，确保源数据中每个地址只出现一次：

USING (
    SELECT DISTINCT
        Address_Line_1,
        Address_Line_2,
        Address_Town,
        Address_County,
        Address_Postcode,
        Address_Country
    FROM RAW_CM_Companies
) AS SOURCE

2. NULL匹配逻辑可以简化（避免潜在漏洞） #

你写的Target.col = Source.col OR (Target.col IS NULL AND Source.col IS NULL)逻辑是对的，但写法比较冗余，容易不小心写错。可以用ISNULL或COALESCE简化，用一个不会出现在实际业务数据中的占位符来统一NULL值的匹配：

ON ISNULL(Target.line_1, '<<NULL_PLACEHOLDER>>') = ISNULL(Source.Address_Line_1, '<<NULL_PLACEHOLDER>>')
AND ISNULL(Target.line_2, '<<NULL_PLACEHOLDER>>') = ISNULL(Source.Address_Line_2, '<<NULL_PLACEHOLDER>>')
AND ISNULL(Target.site_town, '<<NULL_PLACEHOLDER>>') = ISNULL(Source.Address_Town, '<<NULL_PLACEHOLDER>>')
AND ISNULL(Target.site_county, '<<NULL_PLACEHOLDER>>') = ISNULL(Source.Address_County, '<<NULL_PLACEHOLDER>>')
AND ISNULL(Target.postal_code, '<<NULL_PLACEHOLDER>>') = ISNULL(Source.Address_Postcode, '<<NULL_PLACEHOLDER>>')
AND ISNULL(Target.country, '<<NULL_PLACEHOLDER>>') = ISNULL(Source.Address_Country, '<<NULL_PLACEHOLDER>>')

这样的写法和你原来的逻辑完全一致，但更简洁，不容易出错。

3. 额外检查点 #

• 确认你的唯一约束UQ__address__0562CB2F819EDD16确实覆盖了line_1, line_2, site_town, site_county, postal_code, country这6列，没有遗漏或列名错误；
• 如果是多线程并发执行MERGE，即使加了HOLDLOCK，也可能出现竞态条件，但如果是单线程测试的话，这个可能性很低；
• 检查是否存在大小写或空格差异导致的“看似相同实则不同”的记录（比如United Kingdom和 United Kingdom带前导空格），不过错误提示里的重复值是完全一致的，这个概率不高。

先试试给源数据加DISTINCT去重，应该能解决你的问题！

备注：内容来源于stack exchange，提问作者TWilliamson