未显式声明userid却触发INSERT子句列重复指定报错原因排查

咱们来一步步拆解你遇到的这个问题——这个错误看起来是你没碰userid却触发的，但本质是EF Core生成的SQL语句出了问题，和数据库的规则冲突了。

一、错误的核心含义 #

The column name 'userid' is specified more than once in the SET clause or column list of an INSERT

这是数据库引擎直接抛出的错误，意思很明确：当执行插入或更新操作时，你提交的SQL语句里，userid列被重复放到了字段列表里（或者更新时重复赋值），数据库不知道该用哪个值来处理这个列，所以直接报错。举个例子，错误的SQL可能长这样：

INSERT INTO Ratings (Bookid, Type, Rating, Userid, Userid) 
VALUES (123, 'Books', 1, '00000000-0000-0000-0000-000000000000', ...)

二、为什么没显式操作Userid却触发错误？ #

从你的代码和实体类来看，问题大概率出在EF Core的实体映射和数据库结构不匹配上，结合你的场景，有几个最可能的原因：

1. 不可空的Userid未赋值，触发EF生成异常SQL #

你的Ratings实体里，Userid是非可空的Guid类型（public Guid Userid { get; set; }），但你创建newRating时完全没给它赋值。这时候EF Core会自动用Guid.Empty（全0的Guid）作为默认值，但如果Ratings对应的是数据库视图而非物理表，而视图的定义里重复包含了userid列（比如关联Users表时，同时选了Ratings.Userid和Users.Userid，还没给其中一个加别名），EF生成的INSERT语句就会试图给两个同名的userid列赋值，直接触发错误。

2. EF Core实体映射存在重复配置 #

检查你的DbContext配置，有没有在Fluent API里重复映射Userid列？比如不小心写了两次：

modelBuilder.Entity<Ratings>()
    .Property(r => r.Userid)
    .HasColumnName("userid");
// 又重复配置了一次
modelBuilder.Entity<Ratings>()
    .Property(r => r.User)
    .HasColumnName("userid");

这种重复映射会让EF生成的SQL里重复出现userid列。

3. 数据库表/视图本身有重复列 #

直接去数据库里检查Ratings表（或视图），有没有两个名为userid的列？比如手动添加过重复列，或者视图关联时不小心重复引入了该列。

三、排查与解决步骤 #

1. 查看EF Core生成的SQL语句：
   在你的DbContext配置里开启日志，就能看到SaveChanges时生成的真实SQL，一眼就能定位是不是重复了userid。比如在Program.cs里添加：

   builder.Logging.AddConsole();
   builder.Logging.SetMinimumLevel(LogLevel.Information);
   

   运行代码后，控制台会输出EF生成的SQL，直接找到问题所在。

2. 匹配实体与数据库结构：

   • 如果是操作视图：检查视图的定义，删掉重复的userid列，或者给重复的列加别名（比如Users.Userid AS User_Userid）。
   • 如果是物理表：确认表中只有一个userid列，且实体类的Userid属性正确映射到该列。

3. 显式给Userid赋值：
   既然Userid是不可空类型，建议创建newRating时显式赋值（哪怕是临时测试值），避免EF用默认值时触发异常：

   newRating.Userid = Guid.NewGuid(); // 换成你实际的用户ID逻辑
   

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