SQL错误2627违反UNIQUE KEY约束但输入数据无重复问题求解

可能的原因 #

• EF上下文跟踪残留：你的代码吞了插入异常但没有清理出错的实体，该实体会一直保留在EF上下文的待提交队列中。后续每次调用SaveChanges()时，EF都会尝试重新插入这个之前插入失败的实体，你看到的重复值就是这个残留实体的字段值，自然不会出现在当前循环的待插入数据中。
• 唯一约束字段匹配错误：你的表一共设置了3个唯一键，分别是Number、MLFB、Description，报错的重复值不一定来自MLFB字段，你可能只检查了MLFB列的输入，忽略了另外两个字段。
• 不可见字符或排序规则问题：输入数据中对应字段可能包含零宽空格、换行符、首尾空格等不可见字符，肉眼识别不到，但数据库判断唯一约束时会匹配；另外如果数据库排序规则不区分大小写，也可能出现大小写不同但被判定为重复的情况。
• 上下文存在其他待插入实体：你可能在这段循环逻辑之前，已经向同一个数据库上下文的MLFBCodes集合中添加过其他实体未提交，也会随本次循环的SaveChanges()一起插入。

解决步骤 #

1. 先补全异常日志，取出完整的SQL报错信息，SQL Server的唯一键冲突报错会明确标注冲突对应的索引名称，你可以直接定位到是Number/MLFB/Description三个字段中哪一个的重复。
2. 执行以下SQL查询确认数据库中已存在的重复数据：

SELECT * FROM [dbo].[MLFBCodes] 
WHERE 
[Number] = N'A5E037667170010EE0' 
OR [MLFB] = N'A5E037667170010EE0'
OR [Description] = N'A5E037667170010EE0'

3. 修复EF上下文逻辑：要么在捕获到插入异常后，将出错的实体从上下文中分离（Detach），要么每次循环使用独立的数据库上下文实例，避免残留实体干扰。参考修复后的代码：

foreach(MLFBCode code in mLFBsForAdd)
{
    try
    {
        db.MLFBCodes.Add(code);
        db.SaveChanges();
    }
    catch (Exception ex)
    {
        // 打印异常日志便于排查
        Console.WriteLine(ex.ToString());
        // 移除出错的实体，避免残留到下一次提交
        db.Entry(code).State = EntityState.Detached;
    }
}

4. 校验待插入数据的原始值，排查是否存在不可见字符，可以将对应字段的字符编码打印出来逐一对比。

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