SQL MERGE执行upsert时出现重复插入问题的解决方案

问题根因 #

MERGE语法有一个强制约束：USING子句返回的源结果集，必须保证ON条件中使用的关联键唯一，不能出现1个源端键匹配多个源行的情况，否则会触发非确定性执行：不同数据库可能出现重复插入、重复更新、甚至直接抛出多行匹配目标行的错误。
你遇到的重复问题本质是源端结果集没有真正按关联键（userid + 固定值col2='string2'）去重：

1. 你虽然写了DISTINCT，但投影列里除了userid都是常量，部分数据库的MERGE执行计划不会按预期做全局去重，当table2中同一个userid有多条符合type筛选的记录（比如user6有type=b、type=c两条记录）时，会生成多条同userid的源记录参与关联。
2. 你尝试用GROUP BY替代DISTINCT没有生效，大概率是分组时携带了非关联键字段（比如type列），没有真正实现每个userid只返回1行。
3. 你在WHEN MATCHED THEN UPDATE后额外加的where t1.col2 = 'string2'是冗余逻辑，ON条件里已经限定了t1.col2 = src.s2 = 'string2'，能匹配上的行必然满足该条件，冗余过滤可能在部分数据库中导致匹配判定异常。

修正后的SQL #

直接在USING子句中显式按关联键userid分组，从根源保证每个userid只返回1条源记录，移除UPDATE后冗余的过滤条件即可：

MERGE INTO table1 t1
USING (
    SELECT 
        'string1' AS s1, 
        'string2' AS s2, 
        userid, 
        'string3' AS s3
    FROM table2 
    WHERE type IN ('a','b','c','d')
    -- 显式按关联键分组，100%保证每个userid仅返回1行
    GROUP BY userid
) src
ON (t1.userid = src.userid AND t1.col2 = src.s2)
WHEN MATCHED THEN 
    UPDATE SET t1.col3 = src.s3
WHEN NOT MATCHED THEN 
    INSERT (col1, col2, userid, col3)
    VALUES (src.s1, src.s2, src.userid, src.s3);

预期执行结果 #

执行后不会再出现user6的重复行，结果完全符合"匹配则更新、不匹配则插入"的逻辑：

注意事项 #

• 所有支持MERGE的数据库（Oracle、SQL Server、PostgreSQL、MySQL 8+等）都要求源端关联键唯一，写MERGE时必须优先保证该约束，不要依赖DISTINCT对常量列的去重效果。
• 关联过滤逻辑统一写在ON子句中，不要在MATCHED分支的UPDATE/DELETE后重复加相同的过滤条件，避免引发匹配逻辑异常。

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