EF Core怎么配置复合主键 EF Core复合主键(Composite Key)配置方法

来源：这里教程网时间：2026-02-21 17:33:34 作者：

EF Core 配置复合主键只能用 Fluent API，数据注解（比如

[Key]

）不支持多个字段，也不推荐用字符串数组硬编码方式——它缺乏类型安全，重构时容易出错。

必须用 OnModelCreating 中的 HasKey

在你的 DbContext 类中重写

OnModelCreating

方法，调用

modelBuilder.Entity<t>().HasKey(...)</t>

，传入一个匿名类型 lambda 表达式：

正确写法：
modelBuilder.Entity<orderdetail>().HasKey(od => new { od.OrderId, od.ProductId });</orderdetail>
属性名顺序不影响唯一性，但会影响数据库索引的物理顺序（比如先 OrderId 再 ProductId，查询条件含 OrderId 时效率更高） 这两个属性不能为 null —— 值类型（如
int
）天然满足；引用类型（如
string
）需加
[Required]
或设为不可空引用类型（
string!
+
#nullable enable
）

实体类本身不用加任何特性

复合主键的字段不需要标记

[Key]

、

[DatabaseGenerated]

或其他主键相关注解。这些注解会被 EF Core 忽略，甚至可能引发冲突。干净定义即可：

public int OrderId { get; set; }
public int ProductId { get; set; }
其他普通属性照常写，比如
public decimal Quantity { get; set; }

查询和操作要注意语法差异

使用复合主键时，

Find

和

FindAsync

要传入值的顺序和数量必须严格匹配主键定义顺序：

context.OrderDetails.Find(1001, 205);
✅（OrderId=1001，ProductId=205）
context.OrderDetails.FindAsync(new object[] { 1001, 205 });
✅（异步版，用 object 数组） LINQ 查询仍用常规写法：
context.OrderDetails.FirstOrDefault(x => x.OrderId == 1001 && x.ProductId == 205);