ASP.NET Core 6 Web API中CS1998警告及异步实现问题解决

问题原因分析 #

CS1998警告 #

你标记了async方法但未使用await操作符，当前代码仅构建了查询表达式（IQueryable），并未真正执行数据库查询，方法会同步运行，因此触发警告。

CS1061错误 #

IQueryable是延迟执行的查询表达式，本身不是异步任务，没有GetAwaiter方法，不能直接await。EF Core的异步查询需通过专门的扩展方法（如ToListAsync）触发，这类方法会真正执行数据库查询并返回可等待的Task<T>。

正确实现方案 #

1. 调整返回类型 #

异步执行数据库查询后会得到具体的结果集合，需将返回类型从Task<IQueryable<Score>>改为Task<List<Score>>（或Task<IEnumerable<Score>>）。

2. 使用EF Core异步扩展方法 #

在查询末尾调用ToListAsync()（需引入Microsoft.EntityFrameworkCore命名空间），并用await等待查询结果。

3. 优化日期查询逻辑 #

原代码中StartDate.ToString("dd/MM/yyyy")会触发客户端评估（将全量数据拉取到内存后再处理），严重影响性能。改用EF Core支持的数据库端日期格式化方法EF.Functions.DateFormat，让查询逻辑在数据库端执行。

修改后的代码示例 #

using Microsoft.EntityFrameworkCore;
using System.Globalization;

public async Task<List<Score>> GetExamScoreAsync(PagingFilter filter)
{
    var query = _dbContext.Scores
        .Where(m => !m.Approval.IsFirstLevel) // 简化强制转换，假设IsFirstLevel为bool类型
        .OrderByDescending(x => x.CreatedAt);

    // 处理搜索条件，避免重复计算
    if (!string.IsNullOrEmpty(filter.SearchQuery))
    {
        var searchLower = filter.SearchQuery.ToLower();
        query = query.Where(x => 
            x.Subject.ToLower().Contains(searchLower)
            || EF.Functions.DateFormat(x.StartDate, "dd/MM/yyyy").ToLower().Contains(searchLower)
            || EF.Functions.DateFormat(x.EndDate, "dd/MM/yyyy").ToLower().Contains(searchLower));
    }

    // 异步执行查询，获取结果集合
    return await query.ToListAsync();
}

额外说明 #

• 若需要分页，可在ToListAsync()前添加分页逻辑：

  query = query.Skip((filter.PageNumber - 1) * filter.PageSize).Take(filter.PageSize);
  

• 确保项目已安装Microsoft.EntityFrameworkCore NuGet包，并在代码中引入对应命名空间。
• 避免在IQueryable中调用无法转换为SQL的.NET方法，否则会触发客户端评估，降低查询性能。

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