EF Core 中无主键实体需显式声明为只读查询类型,通过 HasNoKey() 或 [Keyless] 配置,并必须绑定 ToView() 或 ToTable();不可变更跟踪,不支持 Find/SaveChanges,适用于视图、原生 SQL 等场景。

EF Core 中配置无主键实体,核心就是告诉框架“这个类型没有主键、不参与变更跟踪、只读查询用”。它不是 bug,而是明确设计的查询类型(Query Type),适用于视图、聚合结果、原始 SQL 返回等场景。
必须显式声明无键:HasNoKey() 或 [Keyless]
EF Core 不会自动识别无主键类,必须手动配置。两种等效方式:
-
Fluent API 方式(推荐):在
OnModelCreating中调用.HasNoKey() -
数据注解方式:给类加
[Keyless]特性(需引用Microsoft.EntityFrameworkCore)
例如:
modelBuilder.Entity() .HasNoKey() .ToView("ViewPlayerClub"); // 映射到数据库视图
或
[Keyless]
public class PlayerClub
{
public Guid PlayerId { get; set; }
public string PlayerName { get; set; }
public string ClubName { get; set; }
public string ClubCity { get; set; }
}
必须指定数据源:ToView() 或 ToTable()
无键实体不能凭空存在,必须绑定到一个数据库对象:
-
.ToView("ViewName"):明确指向视图(语义更清晰) -
.ToTable("TableName"):也可指向无主键的表(EF Core 仍按只读处理)
注意:如果不写 ToView 或 ToTable,迁移命令会尝试为它建表,但因无主键而失败。
查询行为与限制要清楚
无键实体查出来默认是 No-Tracking,这意味着:
- 不能用
Find()—— 编译通过但运行时报错(Find依赖主键) - 不能调用
Add()/Update()/Remove() - 不能作为关系中的主体(即不能有导航属性指向它)
- 可以有导航属性指向常规有键实体(如
public Blog Blog { get; set; }),但反过来不行
合法查询示例:
var results = context.PlayerClubs
.Where(x => x.ClubCity.Contains("贵州"))
.ToList();
常见用途和典型场景
无键实体不是“缺陷补救”,而是为特定需求设计的轻量查询载体:
- 映射数据库视图(最常用)
- 封装原生 SQL 查询结果(配合
FromSqlRaw) - 接收存储过程返回的结果集
- 表示聚合查询(如
SELECT COUNT(*) FROM ... GROUP BY) - 临时 DTO 类型,不参与业务状态管理
基本上就这些。配置不复杂,但容易忽略 ToView 和禁用 Find 的细节。










