EF 6适配非规范命名数据库：外键关系配置错误排查

问题背景 #

我有两个数据库表：Products和Files。Products表通过外键列photo_id关联Files表，同时还能通过entity_id和entity_type列关联多个PDF文件。

我想要获取包含对应图片的Products列表，已经定义了以下实体类：

Product类 #

[Table("products")]
public partial class Product : Base
{
    [Key]
    [Column("id")]
    public int? Id { get; set; }

    [Column("name")]
    public string Name { get; set; }

    [Column("photo_id")]
    public int? PhotoId { get; set; }

    public virtual File Photo { get; set; }
    public virtual ICollection<File> Files { get; set; }
}

File类 #

[Table("files")]
public partial class File : Base
{
    [Key]
    [Column("id")]
    public int? Id { get; set; }

    [Column("filename")]
    public string Filename { get; set; }
}

DbContext配置 #

DbContext的OnModelCreating方法暂未做额外配置：

protected override void OnModelCreating(ModelBuilder builder)
{
    base.OnModelCreating(builder);
}

错误信息 #

执行查询时出现如下错误：

"ClassName": "Npgsql.PostgresException",
"Message": "42703: column f.ProductId does not exist",
"Data": {
"Severity": "ERROR",
"InvariantSeverity": "ERROR",
"SqlState": "42703",
"MessageText": "column f.ProductId does not exist",
"Position": 987,
"File": "parse_relation.c",
"Line": "3643",
"Routine": "errorMissingColumn"
},

为什么EF会要求File表存在ProductId列？该如何避免？我使用.NET 6、EF Core 6和PostgreSQL，尝试添加ForeignKey注解未解决问题。

更新1：
经排查错误与Files集合属性相关，我添加ProductFile子类作为鉴别器并配置，但在关联配置时出现语法错误，不知如何正确配置。

原因分析 #

EF Core默认按约定推断实体关联：

• 对于Product.Photo一对一导航属性，EF能通过PhotoId外键推断关联；但Product.Files集合导航属性，EF默认认定为普通一对多关联，期望File表存在ProductId外键列，这和你的数据库实际结构不匹配，因此抛出错误。
• 你的实际场景是Files表通过entity_id+entity_type实现多态关联（一个File可属于不同类型实体），这种自定义关联规则EF无法自动识别，必须手动配置。

解决方案 #

方案1：手动配置多态关联（无需新增子类） #

在OnModelCreating中用Fluent API指定Product.Files的关联条件，适配entity_id和entity_type的结构：

1. 给File类补充对应字段：

[Table("files")]
public partial class File : Base
{
    [Key]
    [Column("id")]
    public int? Id { get; set; }

    [Column("filename")]
    public string Filename { get; set; }

    [Column("entity_id")]
    public int? EntityId { get; set; }

    [Column("entity_type")]
    public string EntityType { get; set; }
}

2. 在DbContext中配置关联规则：

protected override void OnModelCreating(ModelBuilder builder)
{
    base.OnModelCreating(builder);

    // 配置Product与Photo的一对一关联
    builder.Entity<Product>()
        .HasOne(p => p.Photo)
        .WithOne()
        .HasForeignKey<Product>(p => p.PhotoId);

    // 配置Product与Files的多态关联
    builder.Entity<Product>()
        .HasMany(p => p.Files)
        .WithOne()
        .HasPrincipalKey(p => p.Id)
        .HasForeignKey(f => f.EntityId)
        .IsRequired(false)
        .HasFilter("entity_type = 'Product'"); // 过滤出属于Product的文件
}

方案2：使用鉴别器实现TPH继承（对应子类方案） #

如果想用子类+鉴别器的方式，按以下步骤配置：

1. 新增ProductFile子类：

public class ProductFile : File
{
    // 无需新增属性，继承File所有字段
}

2. 修改Product类的集合类型：

public virtual ICollection<ProductFile> Files { get; set; }

3. 在DbContext中配置继承与关联：

protected override void OnModelCreating(ModelBuilder builder)
{
    base.OnModelCreating(builder);

    // 配置Product与Photo的一对一关联
    builder.Entity<Product>()
        .HasOne(p => p.Photo)
        .WithOne()
        .HasForeignKey<Product>(p => p.PhotoId);

    // 配置File表的TPH继承，指定鉴别器列和ProductFile的鉴别值
    builder.Entity<File>()
        .HasDiscriminator<string>("entity_type")
        .HasValue<ProductFile>("Product");

    // 配置Product与ProductFile的关联
    builder.Entity<Product>()
        .HasMany(p => p.Files)
        .WithOne()
        .HasPrincipalKey(p => p.Id)
        .HasForeignKey(f => f.EntityId);
}

4. 给File类补充EntityId字段：

[Column("entity_id")]
public int? EntityId { get; set; }

注意事项 #

• 确保数据库Files表已存在entity_id和entity_type列，且entity_type列的值与配置中的鉴别值（如"Product"）一致。
• 方案2中EF会自动通过鉴别器过滤数据，无需手动添加过滤条件。

内容的提问来源于stack exchange，提问作者Mario Peralta