EF生成含无效列的查询引发PostgresException：列不存在

问题现象 #

使用Entity Framework Core建立Account与AccountStatus的一对多关系时，EF生成的SQL查询中额外包含了accountstatusid1列，导致PostgreSQL抛出错误：

Npgsql.PostgresException (0x80004005): 42703: column a.accountstatusid1 does not exist

生成的错误SQL示例：

SELECT a.accountid, a.accountstatusid, a.accountstatusid1, a.name
FROM account AS a  
WHERE a.accountid = @__accountId_0  
LIMIT 2

问题根源 #

1. 实体类型与数据库不匹配：数据库中accountstatus.accountstatusid是smallint类型，但实体AccountStatus.AccountStatusId定义为int，EF无法正确识别主键关联逻辑。
2. 关系配置不完整：仅使用HasOne声明关系但未指定外键列，EF会自动尝试生成新的外键列（后缀加1），但数据库中不存在该列。
3. 数据库外键约束定义不完整：原数据库的外键约束未明确指定引用的表和列，可能干扰EF的关系识别。

解决方案 #

1. 修正实体类型匹配 #

将AccountStatus的主键类型改为与数据库一致的short：

public class AccountStatus
{
    public short AccountStatusId { get; set; } // 从int改为short，匹配smallint类型
    public string Name { get; set; }
}

2. 完整配置实体关系 #

在DataContext的OnModelCreating中显式指定主键、外键及约束名，避免EF自动生成错误列：

public class DataContext : DbContext
{
    public DbSet<AccountStatus> AccountStatuses { get; set; }
    public DbSet<Account> Accounts { get; set; }

    protected override void OnModelCreating(ModelBuilder modelBuilder)
    {
        // 配置AccountStatus实体映射
        modelBuilder.Entity<AccountStatus>()
            .ToTable("accountstatus")
            .HasKey(s => s.AccountStatusId);

        // 配置Account实体映射及关系
        modelBuilder.Entity<Account>(x => 
        {
            x.ToTable("account");
            x.HasKey(a => a.AccountId);
            
            // 建立与AccountStatus的关联，指定已存在的外键列
            x.HasOne(a => a.AccountStatus)
              .WithMany() // 若需反向导航可改为.WithMany(s => s.Accounts)，并在AccountStatus中添加ICollection<Account> Accounts属性
              .HasForeignKey(a => a.AccountStatusId)
              .HasConstraintName("fk_accountstatusidid"); // 匹配数据库中的外键约束名
        }); 
    }
}

3. 修正数据库外键约束（可选但推荐） #

原数据库外键约束定义不完整，补充引用规则确保约束有效：

-- 删除原有不完整约束
ALTER TABLE account
DROP CONSTRAINT fk_accountstatusidid;

-- 创建完整外键约束
ALTER TABLE account
ADD CONSTRAINT fk_accountstatusidid 
FOREIGN KEY (accountstatusid) REFERENCES accountstatus(accountstatusid);

验证 #

完成上述修改后，EF生成的SQL查询将不再包含accountstatusid1列，会正确使用数据库中已有的accountstatusid列进行关联查询。

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