EF Core 配置复合主键必须使用 Fluent API 的 HasKey 方法，不可用数据注解；需在 OnModelCreating 中指定匿名类型 lambda 表达式，如 od => new { od.OrderId, od.ProductId }；字段须非空且不加任何主键特性。
EF Core 配置复合主键只能用 Fluent API，数据注解（比如 [Key]）不支持多个字段，也不推荐用字符串数组硬编码方式——它缺乏类型安全，重构时容易出错。
必须用 OnModelCreating 中的 HasKey
在你的 DbContext 类中重写 OnModelCreating 方法，调用 modelBuilder.Entity，传入一个匿名类型 lambda 表达式：
- 正确写法：
modelBuilder.Entity().HasKey(od => new { od.OrderId, od.ProductId }); - 属性名顺序不影响唯一性，但会影响数据库索引的物理顺序（比如先 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);
别混淆复合主键和业务唯一约束
如果业务上需要一个“看起来像主键”的字段（比如订单号），但又想保留高性能的自增 ID 主键，就不要强行用它做复合主键。应该：
- 用
.HasKey(e => e.Id)设技术主键 - 用
.HasAlternateKey(e => e.OrderNumber)加业务唯一约束 - 这样既保证迁移和查询稳定，又防止重复订单号
基本上就这些。不复杂但容易忽略细节，尤其顺序和可空性。
