EF Core 中配置无主键实体,核心就是告诉框架“这个类型没有主键、不参与变更跟踪、只读查询用”。它不是 bug,而是明确设计的查询类型(Query Type),适用于视图、聚合结果、原始 SQL 返回等场景。
必须显式声明无键:HasNoKey() 或 [Keyless]
EF Core 不会自动识别无主键类,必须手动配置。两种等效方式:
Fluent API 方式(推荐):在OnModelCreating中调用
.HasNoKey()数据注解方式:给类加
[Keyless]特性(需引用
Microsoft.EntityFrameworkCore)
例如:
modelBuilder.Entity<PlayerClub>()
.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的细节。
