ASP.NET Core Web API：Linq查询无法返回RoleId为Null的员工问题

问题原因 #

1. NULL值的比较逻辑限制
   在SQL和LINQ的查询规则中，NULL与任何值进行不等（!=）比较时，结果既不是true也不是false，而是UNKNOWN。原查询的where employee.RoleId != roleId会自动过滤掉所有RoleId为NULL的员工记录，因为这类记录无法满足条件。

2. 实体类属性定义错误
   若Employee实体中的RoleId被定义为非可空的int类型（而非int?），EF Core会将该属性映射为数据库中的非空列。即便数据库里RoleId是可空列，EF也会默认忽略RoleId为NULL的记录——因为它认为该属性不可能为NULL，不会加载对应数据。

3. 外键关联的默认连接方式问题
   如果Employee实体配置了与EmployeeRole的导航属性，且关联配置默认使用内连接，会导致RoleId为NULL的员工被过滤。内连接只返回两边表都有匹配的记录，无匹配的NULL外键记录会被排除。

解决方法 #

1. 修正查询条件，包含NULL值 #

调整WHERE子句，明确将RoleId为NULL的记录纳入结果：

public async Task<IEnumerable<Employee>> GetEmployeesNotInRoleAsync(int roleId)
{
    var employees = await (from employee in this.dataContext.Employees
                           where employee.RoleId != roleId || employee.RoleId == null
                           select new Employee
                           {
                               Id = employee.Id,
                               Name = employee.FullName,
                               Status = employee.Name,
                               RoleId = employee.RoleId,
                            }).ToListAsync().ConfigureAwait(false);
 
    return employees;
}

也可以使用方法语法简化：

public async Task<IEnumerable<Employee>> GetEmployeesNotInRoleAsync(int roleId)
{
    var employees = await dataContext.Employees
        .Where(e => e.RoleId != roleId || e.RoleId == null)
        .Select(e => new Employee
        {
            Id = e.Id,
            Name = e.FullName,
            Status = e.Name,
            RoleId = e.RoleId
        })
        .ToListAsync().ConfigureAwait(false);
 
    return employees;
}

2. 修正实体类的RoleId属性定义 #

确保Employee实体中的RoleId是可空整数类型：

public class Employee
{
    public int Id { get; set; }
    public string FullName { get; set; }
    public string Name { get; set; }
    public int? RoleId { get; set; } // 必须定义为可空类型
    // 导航属性（如果存在）
    public virtual EmployeeRole Role { get; set; }
}

3. 配置外键关联为左外连接 #

若使用导航属性，在DbContext的OnModelCreating方法中显式配置外键为非必须，确保使用左外连接加载数据：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    modelBuilder.Entity<Employee>()
        .HasOne(e => e.Role)
        .WithMany() // 根据实际关联关系调整为对应的集合属性
        .HasForeignKey(e => e.RoleId)
        .IsRequired(false); // 明确指定外键可空
}

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