升级至VS2022(.NET Core7)后SingleOrDefault抛出InvalidOperationException异常

问题场景 #

以下代码在.NET 5（VS 2019）环境下运行正常，但升级至.NET 7（VS 2022）后抛出InvalidOperationException: Sequence contains more than one matching异常，且数据库中UserID是主键列，不存在符合过滤条件的重复记录：

DBL_APP_USER user = _db.DBL_APP_USER.SingleOrDefault(
    a => a.UserID == login.UserID && a.Password == login.Password && a.IsActive == true
);

可能原因 #

1. EF Core 查询执行逻辑变化：.NET 7对SingleOrDefault的查询翻译和执行时机做了调整，部分场景下不再优先利用主键索引在数据库层面完成过滤，而是将更多数据加载到内存后再执行判断，导致内存中出现多条匹配记录（尽管数据库中主键唯一）。
2. 客户端求值触发：若EF Core无法将部分过滤表达式翻译为SQL，会触发客户端求值，数据库返回的数据量超出预期，进而在内存执行SingleOrDefault时抛出异常。
3. 实体主键配置问题：若EF Core未正确识别UserID为主键，会导致查询无法利用主键索引优化，可能返回意外结果。

解决方案 #

1. 优先通过主键查询，再验证附加条件 #

利用主键索引确保数据库仅返回一条记录，再在内存中验证密码和激活状态，从根源避免多条记录问题：

var user = _db.DBL_APP_USER.Find(login.UserID);
if (user != null && user.Password == login.Password && user.IsActive)
{
    // 后续业务逻辑
}

或通过分步过滤的方式，强制EF先利用主键过滤：

var user = _db.DBL_APP_USER
    .Where(a => a.UserID == login.UserID)
    .SingleOrDefault(a => a.Password == login.Password && a.IsActive == true);

2. 检查生成的SQL语句 #

通过ToQueryString()查看EF生成的SQL，确认所有过滤条件都被正确翻译到数据库层面执行：

var query = _db.DBL_APP_USER.Where(a => a.UserID == login.UserID && a.Password == login.Password && a.IsActive == true);
Console.WriteLine(query.ToQueryString());

若SQL中缺少部分条件，说明存在EF无法翻译的表达式，需调整过滤逻辑，确保所有条件都能被转换为SQL。

3. 确认实体主键配置正确性 #

检查DBL_APP_USER实体的主键配置，确保EF Core正确识别UserID为主键。例如使用Fluent API配置：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    modelBuilder.Entity<DBL_APP_USER>()
        .HasKey(entity => entity.UserID);
}

4. 禁用客户端求值（可选） #

在.NET 7中可配置EF Core禁用客户端求值，强制所有查询在数据库层面执行，提前暴露翻译问题：

protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
{
    optionsBuilder
        .UseSqlServer("你的连接字符串")
        .ConfigureWarnings(warnings => warnings.Throw(RelationalEventId.ClientEvaluationWarning));
}

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