ASP.NET Core中主键关联的主从表数据查询问题

问题场景 #

将旧WebForms网站迁移至ASP.NET Core，现有ASPNetUsers主表与POC表通过Id列建立一对一关联。编写模型类后，使用Include查询关联数据时返回null，移除Include仅能获取主表数据。

现有模型类 #

UserViewModel（映射ASPNetUsers表）

using System.ComponentModel.DataAnnotations.Schema;

namespace Core.Models
{
    [Table("ASPNetUsers")]
    public class UserViewModel
    {
        [System.ComponentModel.DataAnnotations.Key]
        public string Id { get; set; }

        public string UserName { get; set; }
        public string Email { get; set; }
        public string? FirstName { get; set; }
        public string? LastName { get; set; }
        public string? MobilePIN { get; set; }
        public string? PhoneNumber { get; set; }
        public string? PhoneExt { get; set; }

        public POC? POC { get; set; }
    }
}

POC（映射POC表）

using System.ComponentModel.DataAnnotations;
using System.ComponentModel.DataAnnotations.Schema;

namespace TRRWSCore.Models
{
    [Table("POC")]
    public class POC
    {
        [Key]
        [DatabaseGenerated(DatabaseGeneratedOption.Identity)]
        public string Id { get; set; }

        public string? UserId { get; set; }

        [ForeignKey("UserId")]
        public virtual UserViewModel? User { get; set; }

        public string? POCAddress1 { get; set; }
        public string? POCAddress2 { get; set; }
        public string? POCCity { get; set; }
        public string? POCState { get; set; }
        public string? POCZip { get; set; }
        public string? POCTitle { get; set; }
        public string? POCFax { get; set; }
        public bool? ThirdPartyConsultant { get; set; }
    }
}

尝试的查询代码 #

无效写法（Include中不能直接添加条件）：

UserViewModel = await _context.UserInfoDbSet
                              .Include(p => p.POC.Id == id)
                              .Where(a => a.Id == id)
                              .FirstOrDefaultAsync();

格式正确但未生效的写法：

UserViewModel = await _context.UserInfoDbSet
                              .Include(p => p.POC)
                              .Where(a => a.Id == id)
                              .FirstOrDefaultAsync();

问题原因 #

当前模型的关联配置不符合EF Core对一对一关系的约定：

1. EF Core默认要求一对一关系中，依赖实体的主键同时作为主实体的外键，但你的POC类有独立的自增主键Id，仅用UserId作为外键，EF Core会默认识别为一对多关系（一个用户可对应多个POC），无法正确映射一对一关联。
2. 未显式配置一对一关系的约束（比如UserId列的唯一索引），数据库层面也可能缺少唯一约束，导致EF Core无法确定关联关系。

解决方案 #

根据你的数据库结构，提供两种可行的修正方案：

方案1：调整POC模型主键为外键（符合EF Core一对一约定） #

将POC的主键改为UserId，使其同时作为关联UserViewModel的外键，完全匹配一对一关系的默认约定：

using System.ComponentModel.DataAnnotations;
using System.ComponentModel.DataAnnotations.Schema;

namespace TRRWSCore.Models
{
    [Table("POC")]
    public class POC
    {
        // 将UserId设为主键，同时作为User的外键
        [Key]
        [ForeignKey("User")]
        public string UserId { get; set; }

        public virtual UserViewModel? User { get; set; }

        // 保留原有业务属性
        public string? POCAddress1 { get; set; }
        public string? POCAddress2 { get; set; }
        public string? POCCity { get; set; }
        public string? POCState { get; set; }
        public string? POCZip { get; set; }
        public string? POCTitle { get; set; }
        public string? POCFax { get; set; }
        public bool? ThirdPartyConsultant { get; set; }
    }
}

方案2：保留POC独立主键，用Fluent API显式配置一对一关系 #

如果需要保留POC的自增Id，在DbContext的OnModelCreating方法中显式配置一对一关系，并添加唯一索引约束：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    // 配置UserViewModel与POC的一对一关系
    modelBuilder.Entity<UserViewModel>()
        .HasOne(u => u.POC) // 一个用户对应一个POC
        .WithOne(p => p.User) // 一个POC属于一个用户
        .HasForeignKey<POC>(p => p.UserId) // POC的UserId作为外键
        .IsRequired(false); // 允许用户无关联POC（根据业务调整）

    // 为POC的UserId添加唯一索引，确保一对一约束
    modelBuilder.Entity<POC>()
        .HasIndex(p => p.UserId)
        .IsUnique();
}

正确查询方式 #

完成模型配置后，使用以下查询即可获取包含关联POC数据的完整结果：

UserViewModel = await _context.UserInfoDbSet
                              .Include(u => u.POC)
                              .Where(u => u.Id == id)
                              .FirstOrDefaultAsync();

额外检查项 #

1. 确认数据库中POC表存在UserId等于目标用户Id的记录；
2. 确保DbContext中已注册两个模型的DbSet：

   public DbSet<UserViewModel> UserInfoDbSet { get; set; }
   public DbSet<POC> POCs { get; set; }
   

3. 检查模型命名空间，确保UserViewModel能正确引用POC类（可通过调整命名空间或添加using解决）。

内容的提问来源于stack exchange，提问作者L. Wallach