EF Core如何通过Fluent API配置无外键属性的一对多关系

实体类代码 #

public class UserAccount
{
    public Guid Id { get; set; }

    public string Username { get; set; }
    public string Password { get; set; }
}

public class UserAccountAuthenticationHistory
{
    public Guid Id { get; set; }

    // 对应外键的导航属性
    public UserAccount UserAccount { get; set; }

    public int Code { get; set; }
}

数据库表结构 #

-- 简易用户账户表
CREATE TABLE [dbo].[UserAccount]
(
    [Id] UNIQUEIDENTIFIER PRIMARY KEY NOT NULL,
    [Username] NVARCHAR(13) CONSTRAINT [DF_UserAccount_Username] DEFAULT('') NOT NULL,
    [Password] NVARCHAR(60) CONSTRAINT [DF_UserAccount_Password] DEFAULT('') NOT NULL
)

-- 标准认证历史表
CREATE TABLE [dbo].[UserAccountAuthenticationHistory]
(
    [Id] UNIQUEIDENTIFIER PRIMARY KEY NOT NULL,
    [UserAccountId] UNIQUEIDENTIFIER CONSTRAINT [DF_UserAccountAuthenticationHistory_UserAccountId] NOT NULL,
    [Code] INT CONSTRAINT [DF_UserAccountAuthenticationHistory_Code] DEFAULT(0) NOT NULL,

    FOREIGN KEY (UserAccountId) REFERENCES [UserAccount](Id)
)

核心问题 #

在EF Core中使用Fluent映射（IEntityTypeConfiguration）时，该如何定义此关系？此关系的名称是什么？是否为一对零关系？要求不使用EF Core的任何默认约定（如virtual关键字或在UserAccountAuthenticationHistory中添加UserAccountId属性）。

已实现的解决方案代码 #

public override void Configure(EntityTypeBuilder<UserAccountAuthenticationHistory> builder)
{
    builder
        .HasOne(x => x.UserAccount)
        .WithMany()
        .IsRequired(true);

    builder.Property(x => x.Code)
        .HasDefaultValue(0)
        .IsRequired(true);

    base.Configure(builder);
}

解决方案原理及生效原因 #

1. HasOne(x => x.UserAccount)：指定UserAccountAuthenticationHistory实体拥有一个UserAccount类型的导航属性，明确这是关系中**从属方（依赖端）到主体方（主端）**的关联。
2. .WithMany()：表示UserAccount实体可以对应多个UserAccountAuthenticationHistory实体，空参数意味着主端UserAccount无需定义反向导航属性，完全符合不依赖默认约定的需求。
3. .IsRequired(true)：强制要求该外键关系必须存在，对应数据库中UserAccountId字段的NOT NULL约束，确保每条认证记录都必须关联一个有效的用户账户。
4. EF Core隐式外键处理：由于实体类未定义UserAccountId属性，EF Core会自动匹配数据库中同名的UserAccountId字段作为隐式外键，完成一对多关系的绑定，无需显式声明实体属性。

关系说明 #

• 该关系是一对多关系：一个UserAccount可以对应多条UserAccountAuthenticationHistory记录，每条认证记录必须属于一个用户。
• 并非一对零关系：一对零关系指主实体可无从属实体，且从属实体最多对应一个主实体（如用户与可选的用户档案），而此处从属实体必须关联主实体（IsRequired(true)），且主实体可关联多个从属实体，属于标准的一对多强制关联。

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