Entity Framework Core中误将非实体类Address识别为上下文实体的原因及解决方法问询

这个问题我之前也碰到过！其实是EF Core的模型发现机制在搞鬼，我来给你理清楚原因和解决办法：

为什么会出现这个问题？ #

EF Core遵循约定优先的设计原则，它会自动扫描所有被实体类（比如你的Client）引用的类型——哪怕你没有把这些类型注册为DbSet<T>。默认情况下，EF Core会把这些被引用的类认定为需要单独映射的实体，所以会检查它们是否定义了主键。而你的Address类没有主键，就触发了这个报错。

解决办法（两种常用方式） #

你需要明确告诉EF Core：Address是Client的拥有类型（Owned Type），它的数据应该作为Client实体的一部分持久化，而非独立实体。

方式一：使用数据注解（DataAnnotations）

直接在Address类上添加[Owned]特性，简单直观：

using System.ComponentModel.DataAnnotations.Schema;

[Owned]
public class Address {
    public string City { get; set;}
    public string Country { get; set;}
}

方式二：使用Fluent API（更灵活，推荐）

在你的DbContext的OnModelCreating方法里，显式配置Client的Address属性为拥有类型：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    // 告诉EF Core Address是Client的拥有类型
    modelBuilder.Entity<Client>()
        .OwnsOne(c => c.Address);
}

如果想自定义拥有类型对应的数据库列名，还可以进一步配置：

modelBuilder.Entity<Client>()
    .OwnsOne(c => c.Address, addressBuilder =>
    {
        addressBuilder.Property(p => p.City).HasColumnName("ClientCity");
        addressBuilder.Property(p => p.Country).HasColumnName("ClientCountry");
    });

配置完成后，EF Core会把Address的字段合并到Client对应的数据库表中（默认会带前缀，比如Address_City），完全符合你“代码组织复用+数据持久化到Client实体”的需求。

内容的提问来源于stack exchange，提问作者Carlos Eduardo Germano de Souz