EF Core保存数据时外键值与设置值不符的原因咨询

问题场景 #

现有User与UserSettings两个模型，配置为一对一关系：

public class User : BaseEntity
{
    public string FirstName { get; set; }
    public string SecondName { get; set; }
    public UserSettings? UserSettings { get; set; }
}

public class UserSettings : BaseEntity
{
    public string PreferredLanguage { get; set; }
    public User User { get; set; }
    public string UserId { get; set; }

    public UserSettings()
    {
        User = new User();
        PreferredLanguage = string.Empty;
        UserId = string.Empty;
    }
}

// 关系配置
modelBuilder.Entity<UserSettings>()
            .HasOne(us => us.User)
            .WithOne(u => u.UserSettings)
            .HasForeignKey<UserSettings>(us => us.UserId)
            .IsRequired();

保存时手动设置UserId为现有用户的Id，但保存后UserId值不符：

userSettings.UserId = user.Id;
_appDbContext.UserSettings.Add(userSettings);
            
var res = await _appDbContext.SaveChangesAsync();

仅当将完整User对象赋值给UserSettings.User时，外键值才会正确保存。

核心原因 #

问题根源在UserSettings的构造函数中自动初始化的User对象：

构造函数里的User = new User();会在创建UserSettings实例时，生成一个全新的、未关联任何现有用户的User实体。EF Core处理实体关系时，导航属性的状态优先级高于手动设置的外键字段：

• 当仅设置UserId时，EF Core会追踪到UserSettings.User指向的是一个新的User实体（处于Added状态），在执行SaveChangesAsync时，会先插入这个新User，并将其生成的主键Id赋值给UserSettings.UserId，直接覆盖你手动设置的值，导致最终保存的UserId不符合预期。
• 当赋值现有User对象给UserSettings.User时，EF Core会识别该User是已存在的实体（若该用户已被上下文追踪，或通过Attach关联），不会生成新的User记录，而是直接使用该用户的Id作为外键，因此UserId能正确保存。

解决方法 #

• 移除UserSettings构造函数中User = new User();的初始化代码，让导航属性默认为null，此时EF Core会优先使用你手动设置的UserId。
• 若需保留构造函数，在设置UserId后，将UserSettings.User设为null，或者通过_appDbContext.Attach(user)将现有用户关联到上下文，让EF识别其为已存在实体。

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