.NET 8+EF Core添加迁移报错：同名导航/属性已存在

错误原因分析 #

你的迁移报错核心来自Fluent API配置的三个关键问题：

• 错误使用builder.Property(x => x.UserAddressData)配置导航属性：导航属性是EF Core用于实体关联的逻辑属性，并非数据库字段，用Property方法会让EF Core误将其识别为需要映射到列的属性，与已存在的导航属性冲突。
• HasPrincipalKey<UserData>(x => x.UserAddressData)配置完全错误：主实体的主键应使用UserData.Id，而非导航属性。
• 双向一对一关联未绑定反向导航：WithOne()未指定AddressData中的UserData导航属性，导致EF Core无法正确识别关联关系。

正确配置方案 #

方案1：数据注解（简单直观） #

给AddressData添加显式外键字段，通过注解直接配置关联：

public class UserData
{
    public int Id { get; set; }
    public Guid UserGuid { get; set; }
    public string FirstName { get; set; }
    public string LastName { get; set; }
    public string UserName { get; set; }
    public string Email { get; set; }
    public string Password { get; set; }
    public bool IsEmailConfirmed { get; set; }

    // 导航属性
    public AddressData UserAddressData { get; set; }
}

public class AddressData
{
    public int Id { get; set; }
    public string StreetName { get; set; }
    public string City { get; set; }
    public string Country { get; set; }
    public string Phone { get; set; }
    public string PostalCode { get; set; }

    // 外键字段，关联UserData的主键Id
    public int UserDataId { get; set; }

    // 绑定导航属性与外键
    [ForeignKey(nameof(UserDataId))]
    public UserData UserData { get; set; }
}

这种方式无需额外Fluent API配置，EF Core会自动识别一对一关联。

方案2：Fluent API配置（灵活可控） #

删除错误的Property配置，重新定义关联逻辑：

// UserData的配置类
public void Configure(EntityTypeBuilder<UserData> builder)
{
    builder.ToTable("User");

    // 配置一对一关联：UserData拥有一个AddressData，AddressData属于一个UserData
    builder.HasOne(u => u.UserAddressData)
           .WithOne(a => a.UserData) // 指定反向导航属性
           .HasForeignKey<AddressData>(a => a.UserDataId); // 指定外键在AddressData侧
}

// 对应调整AddressData实体
public class AddressData
{
    public int Id { get; set; }
    public string StreetName { get; set; }
    public string City { get; set; }
    public string Country { get; set; }
    public string Phone { get; set; }
    public string PostalCode { get; set; }

    // 显式外键字段
    public int UserDataId { get; set; }
    public UserData UserData { get; set; }
}

关键注意事项 #

• 一对一关联要求外键唯一，显式添加外键字段可避免EF Core自动生成隐藏列。
• 导航属性无需用builder.Property()配置，它是EF Core的关联逻辑，不映射到数据库列。
• 双向导航必须通过WithOne()指定对应反向属性，否则EF Core会误判为多个独立关联，引发冲突。

完成上述修改后，重新运行Add-Migration NewMigration即可成功生成迁移。

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