EF Core查询朋友列表时Like语句无法翻译的优化问题

核心问题排查 #

首先确认GetAllFriends()返回的IQueryable<User>是否未引入任何客户端评估操作——如果该方法内部使用了AsEnumerable()、AsAsyncEnumerable()、自定义无法转换为SQL的方法，或者对实体做了非映射字段的处理，后续的Where过滤会被迫转为客户端执行，这是报错的根源。

具体解决方案 #

1. 修复GetAllFriends()的IQueryable纯净性

确保GetAllFriends()返回的是直接基于DbSet的查询链，没有客户端转换逻辑。例如：

// 正确的Repository实现示例
public IQueryable<User> GetAllFriends(int currentUserId)
{
    return _context.Friendships
        .Where(f => f.UserId == currentUserId)
        .Select(f => f.Friend); // 直接返回映射的实体，无客户端操作
}

避免在Repository中提前调用ToList()、AsEnumerable()，或添加无法被EF转换为SQL的自定义逻辑。

2. 正确使用EF.Functions.Like

确保过滤的是数据库映射的实体属性，语法正确：

// 服务层过滤代码
var searchKeyword = "Smith";
var filteredFriends = await _friendshipRepository.GetAllFriends(currentUserId)
    .Where(u => EF.Functions.Like(u.FirstName, $"%{searchKeyword}%") 
             || EF.Functions.Like(u.LastName, $"%{searchKeyword}%"))
    .ToListAsync();

如果仍报错，检查EF Core版本（需2.0+支持EF.Functions.Like），或改用EF自动转换的Contains方法：

.Where(u => u.FirstName.Contains(searchKeyword) || u.LastName.Contains(searchKeyword))

注：Contains的大小写敏感取决于数据库的排序规则，如需不区分，可结合数据库端大小写转换：

.Where(u => EF.Functions.Lower(u.FirstName).Contains(searchKeyword.ToLower()))

3. 禁用不必要的客户端评估警告（谨慎使用）

如果GetAllFriends()中存在无法避免的轻量客户端操作，但过滤逻辑是可转换的，可临时调整DbContext配置忽略警告：

// 在DbContext的OnConfiguring方法中
optionsBuilder.ConfigureWarnings(warnings =>
    warnings.Ignore(CoreEventId.ClientEvaluationWarning));

不推荐长期使用，优先修复IQueryable的纯净性。

4. 原生SQL查询兜底

若以上方法均无效，直接使用原生SQL在数据库端完成过滤：

var filteredFriends = await _context.Users
    .FromSqlRaw(@"
        SELECT u.*
        FROM Users u
        JOIN Friendships f ON u.Id = f.FriendId
        WHERE f.UserId = @userId
          AND (u.FirstName LIKE @keyword OR u.LastName LIKE @keyword)",
        new SqlParameter("@userId", currentUserId),
        new SqlParameter("@keyword", $"%{searchKeyword}%"))
    .ToListAsync();

内容的提问来源于stack exchange，提问作者Dmitry Shevchenko