ASP.NET Web API .NET 6中使用LINQ查询SQL bit类型为false的记录时触发SqlNullValueException异常

这个问题我之前碰到过好几次，核心原因很明确：你的数据库里isAssigned列允许存储NULL值，但实体类中对应的IsAssigned属性定义的是非可空的bool类型。当EF Core尝试把数据库中的NULL值映射到非空bool时，就会抛出异常——尤其是你查询== false的时候，EF会扫描所有相关记录，包括那些值为NULL的行，这时候类型转换直接就炸了。

下面给你几个可行的解决办法，按需选择：

方法1：修改实体类属性为可空布尔类型 #

把实体类里的IsAssigned改成bool?（可空布尔类型），让EF能正确处理NULL值：

public class OneTimeCode
{
    // 其他属性...
    public bool? IsAssigned { get; set; }
}

之后你的查询可以直接用原来的写法，因为可空布尔类型的== false会自动排除NULL值：

var records = _todoContext.OneTimeCodes.Where(x => x.IsAssigned == false).ToList();

或者更严谨一点，明确检查非空再判断：

var records = _todoContext.OneTimeCodes
    .Where(x => x.IsAssigned.HasValue && x.IsAssigned.Value == false)
    .ToList();

方法2：修改数据库列，禁止NULL并设置默认值 #

如果业务逻辑里isAssigned本来就不应该为NULL，那从根源上解决最稳妥：修改SQL表的列定义，设置默认值为0（对应false），同时把列设为NOT NULL：

ALTER TABLE OneTimeCodes 
ALTER COLUMN isAssigned BIT NOT NULL DEFAULT 0;

这样数据库里永远不会出现NULL值，你实体类里的IsAssigned保持bool类型即可，原查询语句也能正常运行。

方法3：临时在查询中过滤NULL值（不推荐） #

如果暂时不想改动实体类或数据库结构，可以在LINQ查询里先排除NULL值：

var records = _todoContext.OneTimeCodes
    .Where(x => x.IsAssigned != null && x.IsAssigned == false)
    .ToList();

不过这种方法只是临时 workaround，实体类和数据库结构不一致的话，后续很容易出其他问题，不建议长期使用。

补充：为什么只有查false时出错？ #

当你查询== true时，EF生成的SQL会自动过滤掉NULL值（因为NULL不等于true），不会加载这些行；但查询== false时，EF会尝试加载所有isAssigned为0或NULL的行（SQL中NULL和0的比较逻辑导致），这时候NULL值映射到非空bool就触发了异常。

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