EF Core 映射数据库视图必须用 Keyless 实体，因视图天然无主键，而 EF Core 默认要求每个 DbSet 类型必须定义主键，否则报“EntityType 'X' has no key defined”；必须显式配置 [Keyless] 或 HasNoKey() 并配合 ToView() 或 ToTable() 指定数据源，二者缺一不可。
EF Core 映射数据库视图必须用 Keyless 实体，不能靠约定自动识别，也不支持主键配置或变更跟踪。
为什么直接 DbSet<ViewType> 会报错“EntityType 'X' has no key defined”
EF Core 默认要求每个 DbSet 对应的类型必须有主键（Id 或 TypeId 等约定名），而视图天然无主键。框架不会主动判断“这看起来像视图就跳过主键检查”，它只认配置。
常见错误现象包括：
- 迁移生成失败，提示
The entity type 'PlayerClub' requires a primary key to be defined. - 运行时抛出
InvalidOperationException，内容含has no key defined - 即使加了
[Keyless]但没调用ToView()，仍可能在迁移中尝试建表并失败
必须显式声明 Keyless 并绑定 ToView() 或 ToTable()
两种等效方式任选其一，但二者必须同时存在：声明无键 + 指定数据源。缺一不可。
Fluent API（推荐，集中管理）：
protected override void OnModelCreating(ModelBuilder modelBuilder)
{
modelBuilder.Entity<PlayerClub>()
.HasNoKey() // 必须！告诉 EF 这不是实体，不参与跟踪
.ToView("ViewPlayerClub"); // 必须！指定数据库视图名（大小写需匹配 DB）
}
数据注解（类内声明，需引用 Microsoft.EntityFrameworkCore）：
[Keyless]
public class PlayerClub
{
public Guid PlayerId { get; set; }
public string PlayerName { get; set; }
public string ClubName { get; set; }
public string ClubCity { get; set; }
}
然后仍需在 OnModelCreating 中补上 .ToView("ViewPlayerClub") —— 注解只声明 Keyless，不指定来源。
注意点：
-
ToView("xxx")和ToTable("xxx")在 Keyless 场景下效果一致，都按只读处理；但语义上优先用ToView，避免误导后续维护者 - 视图名必须与数据库中实际名称完全一致（SQL Server 区分大小写取决于排序规则，PostgreSQL 默认小写）
- 如果误写成
ToView("nonexistent_view")，查询时才会报错，如invalid object name 'nonexistent_view'
Keyless 实体能做什么、不能做什么
它本质是“只读查询载体”，不是实体，别当普通 DbSet 用。
支持的操作：
-
context.PlayerClubs.ToList()、.Where(...).FirstOrDefault()等 LINQ 查询 - 可参与
Include关联（仅限指向常规实体的导航属性，例如PlayerClub可含public Player Player { get; set; }） - 映射到定义查询（
HasNoKey().ToView(null).HasSqlQuery("SELECT ...")）
明确禁止的操作：
-
context.PlayerClubs.Find(id)→ 报错：Find is not supported for keyless entity types -
context.PlayerClubs.Add(...)/.Update(...)/.Remove(...)→ 全部无效，SaveChanges不会提交任何变更 - 作为关系的主体（例如不能设
PlayerClub为主表，再加HasOne(...).WithMany()）
容易被忽略的兼容性细节
Keyless 类型从 EF Core 2.1 引入（当时叫 Query Type），3.0 改名，5.0 起支持 [Keyless] 特性。如果你用的是 EF Core 3.1 或更早版本，只能用 HasNoKey()，且必须配合 ToView()。
另一个隐蔽坑点：视图字段名若含空格、横线或关键字（如 order、user），EF Core 默认映射会失败。此时必须显式配置列名：
modelBuilder.Entity<BlogPostsCount>()
.HasNoKey()
.ToView("v_blog_post_count")
.Property(e => e.BlogName).HasColumnName("[blog name]"); // 方括号适配 SQL Server
最后提醒：Keyless 类型的构造函数参数、私有 setter、只读属性都受支持，但别在里面写业务逻辑——它只负责承载查询结果，生命周期极短。
