EF Core生成查询中DateTime.Date转换导致日期查询无结果问题

问题根因 #

查询无匹配结果是两个问题叠加导致：

• 时区基准不统一：数据库配置为UTC格式存储日期，代码中却调用.ToLocalTime()将入参转为本地时区时间，两边时间基准不一致，日期自然无法匹配。
• EF Core翻译逻辑偏差：你写的transaction.TransactionDate.Date == transactionDate.Date条件，EF Core翻译时仅对数据库侧的TransactionDate字段做了CONVERT(date)截断时分秒，传入的参数transactionDate却保留了完整的时分秒值，也就是你看到SQL中@__transactionDate_1是带10:00:00的datetime类型，date类型和带时间部分的datetime做隐式转换比对时，会出现匹配逻辑偏差。

可行解决方案 #

方案1：全链路UTC查询（优先推荐） #

既然数据库已经统一用UTC存储，就全程保持UTC时间做比对，同时用日期范围查询替代.Date相等判断，既解决类型匹配问题，还能命中字段索引，查询性能更好：

// 移除.ToLocalTime()，统一将入参转为UTC时间
DateTime transactionDate = Convert.ToDateTime("2021-11-10T10:00:00").ToUniversalTime();
DateTime utcDayStart = transactionDate.Date;
DateTime utcDayEnd = utcDayStart.AddDays(1);

var transactions2 = _transactionsRepo.Query()
  .Where(transaction => transaction.AccountId == pharmacy.AccountId.Value)
  // 用左闭右开的范围判断，替代.Date截断字段的写法
  .Where(transaction => transaction.TransactionDate >= utcDayStart && transaction.TransactionDate < utcDayEnd)
  .OrderByDescending(transaction => transaction.TransactionDate)
  .Skip(numToSkip)
  .Take(pageSize);

这种写法生成的SQL不会出现字段侧的CONVERT转换，参数类型和数据库字段类型完全一致，不会出现隐式转换的匹配问题。

方案2：本地日期匹配（仅业务必须时使用） #

如果业务要求必须按本地时区的日期做匹配，提前在代码侧截断入参的时分秒。注意这种写法会在数据库侧逐行做时区转换，无法命中TransactionDate字段索引，数据量大时性能较差：

// 显式指定输入时间按UTC解析，再转本地时间后截断到日期
DateTime inputTime = DateTime.Parse("2021-11-10T10:00:00", CultureInfo.InvariantCulture, DateTimeStyles.AssumeUniversal);
DateTime localTargetDate = inputTime.ToLocalTime().Date;

var transactions2 = _transactionsRepo.Query()
  .Where(transaction => transaction.AccountId == pharmacy.AccountId.Value)
  .Where(transaction => transaction.TransactionDate.ToLocalTime().Date == localTargetDate)
  .OrderByDescending(transaction => transaction.TransactionDate)
  .Skip(numToSkip)
  .Take(pageSize);

避坑提示 #

• 你代码里的时间字符串有格式笔误："2021-11-10:T10:00:00"日期和时间部分多了一个冒号，标准ISO8601格式应为"2021-11-10T10:00:00"，解析时间时建议显式指定DateTimeStyles，避免不同服务器的时区配置导致解析结果偏差。
• 做日期等值查询时，优先使用「>= 当日0点 且 < 次日0点」的范围写法，不要在字段上调用.Date、CONVERT等函数，这类写法无法利用字段索引，性能会随数据量增长明显下降。

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