ASP.NET Core Web API统计数据库记录数返回0问题咨询

代码存在4类问题，是导致返回结果为0的核心原因：

• 时区不匹配：筛选逻辑使用x.DateTimeUtc.Date取UTC时间的日期做匹配，但接口传入的date参数如果是本地时区（如国内常用的UTC+8）的日期，二者日期值天然存在偏差。例如数据库存储的UTC时间为2024-06-19 17:00，对应北京时间是2024-06-20 01:00，传入北京时间的2024-06-20做匹配时，UTC时间的日期是19号，完全匹配不到数据。
• EF Core LINQ翻译风险：直接在LINQ中访问DateTime.Date属性，部分低版本EF Core对接不同数据库时，会生成错误的SQL逻辑（如错误的时区转换、字符串截断取日期等），导致筛选条件失效。
• 实现逻辑冗余：当前代码先调用ToListAsync()把所有匹配行全量加载到应用内存，再调用Count()计数，既浪费数据库和应用资源，在数据量较大时还可能引发超时。
• 参数绑定潜在问题：控制器接收DateTime类型参数时，如果没有明确约定日期格式，前端传入带时区偏移的时间字符串时，框架自动绑定的date值可能和预期不一致。

1. 统一时间基准：提前明确统计口径是UTC日期还是业务本地日期，将传入参数转换为对应时区的时间范围，避免跨时区匹配错误。
2. 替换日期相等判断为时间范围查询：放弃使用.Date属性做相等判断，改用「大于等于当日起始时间、小于次日起始时间」的闭开区间逻辑，EF Core可准确翻译为数据库可识别的范围查询，还能命中DateTimeUtc字段上的索引，查询效率更高。
3. 使用数据库侧计数：移除ToListAsync()，直接调用CountAsync()在数据库端完成行数统计，避免全量数据加载的开销。
4. 控制器层增加参数格式校验，明确要求前端传入不带时区偏移的日期字符串（如yyyy-MM-dd格式），避免参数绑定错误。

修复后服务层参考代码 #

public async Task<int?> ScoresUpdated(DateTime date)
{
    // 按业务实际时区调整，示例为国内东八区
    var bizTimeZone = TimeZoneInfo.FindSystemTimeZoneById("China Standard Time");
    var bizDayStart = date.Date;
    // 把业务日期的起止时间转成UTC时间，和数据库存储的DateTimeUtc匹配
    var utcDayStart = TimeZoneInfo.ConvertTimeToUtc(bizDayStart, bizTimeZone);
    var utcDayEnd = utcDayStart.AddDays(1);

    var totalCount = await _eventScheduleContext
                           .ViewPersonEventScore
                           .Where(x => x.DateTimeUtc >= utcDayStart
                                       && x.DateTimeUtc < utcDayEnd
                                       && x.ExamModeId == 1
                                       && x.EventStatusId == 8)
                           .CountAsync();
                           
    return totalCount;
}

排查小技巧：可以开启EF Core的SQL日志输出，拿到接口执行时实际生成的SQL语句和参数，直接在数据库客户端执行，就能快速确认是参数值错误还是SQL逻辑错误。

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