EF Core如何通过一次SaveAsync同时添加User与UserProfile数据？

问题根源 #

你的实体类缺少反向导航属性，且EF Core未正确识别User与UserProfile的一对一关联关系，导致无法自动同步插入关联数据；另外若Id为自增主键，手动指定Id和UserId也会引发冲突。

解决方案 #

1. 完善实体类与关系配置 #

首先为UserProfile添加反向导航属性，并通过Fluent API明确关联规则（推荐，比数据注解更灵活）：

修正后的实体类

[PrimaryKey(nameof(Id))]
public class User
{
    public int Id { get; set; }
    public string Password { get; set; }

    // 正向导航
    public UserProfile UserProfile { get; set; }
}

[PrimaryKey(nameof(UserId))]
public class UserProfile
{
    public int UserId { get; set; }
    public string Name { get; set; }

    // 添加反向导航属性
    public User User { get; set; }
}

在DbContext中配置关联关系

重写OnModelCreating方法，明确一对一关联：

public class AppDbContext : DbContext
{
    public DbSet<User> Users { get; set; }
    public DbSet<UserProfile> UserProfiles { get; set; }

    protected override void OnModelCreating(ModelBuilder modelBuilder)
    {
        // 配置User与UserProfile的一对一关系
        modelBuilder.Entity<User>()
            .HasOne(u => u.UserProfile) // User拥有一个UserProfile
            .WithOne(p => p.User) // UserProfile属于一个User
            .HasForeignKey<UserProfile>(p => p.UserId); // UserProfile的UserId作为外键关联User的Id
    }

    // 其他DbContext配置...
}

2. 正确构造实体并插入 #

如果User.Id是自增主键（如SQL Server的IDENTITY），无需手动指定Id和UserId，EF会自动生成并关联：

User user = new()
{
    Password = "123",
    UserProfile = new()
    {
        Name = "Hello World"
        // 无需设置UserId，EF会自动将User的Id赋值给这里的UserId
    }
};

await context.Users.AddAsync(user);
await context.SaveChangesAsync(); // 这一步会在同一个事务中插入User和UserProfile

如果User.Id是手动指定的非自增主键，只需保证User.Id与UserProfile.UserId一致即可：

User user = new()
{
    Id = 1,
    Password = "123",
    UserProfile = new()
    {
        UserId = 1,
        Name = "Hello World"
    }
};

await context.Users.AddAsync(user);
await context.SaveChangesAsync();

关键说明 #

EF Core的SaveChangesAsync默认会将所有待操作包裹在一个事务中，只要关联关系配置正确，插入User时会自动级联插入关联的UserProfile，保证两个操作要么同时成功，要么同时失败。

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