基于日期的过滤查询无返回记录，求排查原因

以下是几个可能导致该问题的原因及对应解决方案：

• 时区/DateTimeKind不匹配
  若数据库中Created字段存储的是UTC时间，但传入的queryParams.From是本地时间（或DateTimeKind.Unspecified类型），EF Core会自动对参数进行时区转换，导致实际执行的过滤条件和你手动SQL查询的不一致。
  解决方法：

  • 统一时区，将传入参数转为UTC后再过滤：

    if (queryParams.From != null)
    {
        var utcFrom = queryParams.From.Value.ToUniversalTime();
        query = query.Where(x => x.Created >= utcFrom);
    }
    

  • 或者在上下文配置中明确字段的时区规则：

    protected override void OnModelCreating(ModelBuilder modelBuilder)
    {
        modelBuilder.Entity<Record>()
            .Property(r => r.Created)
            .HasConversion(v => v, v => DateTime.SpecifyKind(v, DateTimeKind.Utc));
    }
    

• DateTime精度差异
  数据库Created字段若为datetime2（含毫秒/微秒高精度），而传入的From参数被截断了精度，或EF生成的SQL参数精度与数据库字段不匹配，会导致比对逻辑出现误差。
  解决方法：

  • 查看EF生成的实际SQL，对比参数是否与手动查询一致：

    // 在过滤后添加此行，输出最终查询SQL
    Console.WriteLine(query.ToQueryString());
    

  • 确保传入参数的精度与数据库字段类型匹配，比如保留完整的毫秒/微秒信息。

• 错误的异步执行方式
  使用Task.Factory.StartNew执行EF查询是不良实践，EF Core提供了原生异步方法ToListAsync()，错误的线程调用可能引发上下文线程安全问题，间接导致查询结果异常。
  替换为正确的异步写法：

  var records = await query
      .Skip((queryParams.PageNumber - 1) * queryParams.PageSize)
      .Take(queryParams.PageSize)
      .ToListAsync();
  

• 参数传递错误
  检查queryParams.From的实际值是否符合预期，比如API接口参数解析时是否出现日期格式错误，导致传入的是未来时间（自然无匹配数据）。可在过滤前打印参数确认：

  if (queryParams.From != null)
  {
      Console.WriteLine($"实际传入的From参数：{queryParams.From}");
      query = query.Where(x => x.Created >= queryParams.From);
  }
  

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