EF Core中使用可选主体键关联视图报错，求解决办法

开发者阿泽

2026-7-21

问题分析与解决方案

首先明确：EF Core支持使用非主键的可选主体键，但你的当前配置缺少对“主体键可空”场景的明确声明，导致出现Value cannot be null. (Parameter 'key')错误。

错误原因

当Employee的PositionCode为null时，EF Core默认会尝试用这个null值作为关联键，但你的配置未明确允许主体键为null的关联场景，触发了参数非空校验错误。

修正方案一：调整关联配置

在关联配置中添加.IsRequired(false)，明确告知EF Core该关联是可选的，允许主体端（Employee）的PositionCode为null：

builder.Entity<Employee>()
       .ToView("Employees")
       .HasMany(u => u.PositionRoles)
       .WithOne()
       .HasForeignKey(r => r.PositionCode)
       .HasPrincipalKey(u => u.PositionCode)
       .IsRequired(false); // 声明关联可选，允许主体键为null

同时确保：

Employee类中的PositionCode属性为可空类型（比如public string? PositionCode { get; set; }）
PositionRole类中的PositionCode属性也为可空类型（若存在无关联的PositionRole记录）

修正方案二：手动投影替代Include

如果调整配置后仍有问题，可以通过查询投影的方式手动关联数据，绕开EF Core的自动关联校验：

var employeesWithRoles = await db.Employees
    .Select(e => new
    {
        Employee = e,
        PositionRoles = db.PositionRoles
            .Where(r => r.PositionCode == e.PositionCode)
            .ToList()
    })
    .ToListAsync();

这种方式会直接为每个Employee筛选匹配的PositionRoles，当e.PositionCode为null时，只会返回PositionCode同样为null的PositionRole记录（若无则返回空列表），不会触发错误。