ASP.NET Web API报错：实体类型UserItem需定义主键，求排查

这个异常的核心原因是Entity Framework Core（EF Core）的主键识别规则——你的LoginItem类刚好符合EF Core的默认主键约定，而UserItem没有满足这个规则，所以EF Core无法自动识别它的主键。

为什么LoginItem能正常运行？ #

EF Core默认会把以下两种属性自动识别为主键：

• 命名为Id的属性（只要是数值型、Guid这类适合做主键的类型）
• 命名为[类名]Id的属性（比如LoginItem对应的LoginItemId）

看你的LoginItem代码：

public class LoginItem
{
    public long Id { get; set; } // 完全匹配EF Core的主键约定
    // ...其他属性
}

EF Core自动把Id当作了这个实体的主键，所以对应的上下文和控制器都能正常工作。

为什么UserItem会报错？ #

你的UserItem类里的matrikelnr虽然是适合做主键的int类型，但它的名字既不是Id，也不是UserItemId，EF Core没办法自动识别它为主键，因此抛出了"The entity type 'UserItem' requires a primary key to be defined"的异常。

解决方法（两种任选其一） #

方法1：修改属性名适配约定 #

把matrikelnr改名为Id或者UserItemId，EF Core就会自动识别它为主键：

public class UserItem
{
    public int UserItemId { get; set; } // 或者直接用Id
    public string studiengang { get; set; }
    public string user_semester { get; set; }
    public string user_max_klausur { get; set; }
    
    public UserItem()
    {
        this.UserItemId = 0;
        this.studiengang = "";
        this.user_max_klausur = "";
        this.user_semester = "";
    }
}

方法2：显式标记主键特性 #

如果你不想修改属性名，可以给matrikelnr加上[Key]特性（需要先引用System.ComponentModel.DataAnnotations命名空间）：

using System.ComponentModel.DataAnnotations; // 必须添加这个引用

namespace ModulApi.Models
{
    public class UserItem
    {
        [Key] // 显式标记该属性为主键
        public int matrikelnr { get; set; }
        public string studiengang { get; set; }
        public string user_semester { get; set; }
        public string user_max_klausur { get; set; }
        
        public UserItem()
        {
            this.matrikelnr = 0;
            this.studiengang = "";
            this.user_max_klausur = "";
            this.user_semester = "";
        }
    }
}

验证修改 #

完成上述任意一种修改后，重新运行Web API，EF Core就能正确识别UserItem的主键，UserController里的_context.UserItems.Count()也不会再抛出异常了。

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