TypeORM find方法因日期转换器无法匹配日期记录问题排查

核心问题 #

TypeORM的find方法会对查询条件中的值应用列定义的to转换器，而你的转换器逻辑导致查询条件被转换后，与数据库中存储的UTC日期字符串不匹配，最终查不到预期记录。

具体分析 #

1. TypeORM自动类型转换：当你在find的where中传入字符串today（"2025-06-13"）时，TypeORM会根据实体属性Date | string的定义，自动将该字符串转为Date对象。这个Date对象是基于你的本地时区（欧洲/伦敦）解析的——比如伦敦夏令时（UTC+1）下，new Date("2025-06-13")对应的UTC时间是2025-06-12T23:00:00Z。
2. 转换器to方法处理偏差：你的to方法接收这个Date对象后，通过moment.utc(value).format('YYYY-MM-DD')将其转为UTC日期字符串，结果变成了"2025-06-12"，而非你预期的"2025-06-13"。
3. 查询条件失效：最终生成的SQL条件偏离了预期，即便部分数据理论上仍能匹配，但时区相关的边界逻辑偏差会导致查询结果为空。

而你手动执行的SQL和查询构建器能正常工作，是因为它们直接使用原始字符串作为条件，没有经过转换器的to方法处理。

修复方案 #

方案1：修正转换器to方法逻辑

确保无论传入的是Date对象还是字符串，都能正确转换为预期的UTC日期字符串，明确处理字符串的时区解析：

export class DateTransformer implements ValueTransformer {

  constructor(nullable: boolean = true) {
    this.nullable = nullable;
  }

  protected nullable: boolean;

  to(value: Date | string): string {
    if (!value) {
      return this.nullable ? null : moment.utc().format('YYYY-MM-DD');
    }
    // 处理字符串：假设传入的字符串是欧洲/伦敦时区，转UTC后格式化
    if (typeof value === 'string') {
      return moment.tz(value, 'Europe/London').utc().format('YYYY-MM-DD');
    }
    // 处理Date对象：转UTC后格式化
    return moment.utc(value).format('YYYY-MM-DD');
  }

  from(value: string): string {
    return value ? moment.utc(value).tz('Europe/London').format('YYYY-MM-DD') : null;
  }

}

方案2：直接传入UTC格式日期字符串

手动生成UTC格式的日期字符串，避免TypeORM自动转换为Date对象：

const todayUtc = moment.utc("2025-06-13").format('YYYY-MM-DD');
MyEntity.find({
   where: {
      start: LessThanOrEqual(todayUtc),
      end: Or(MoreThanOrEqual(todayUtc), IsNull())
   }
});

方案3：继续使用查询构建器

正如你发现的，查询构建器默认跳过转换器，直接使用原始条件值，可保持现有逻辑：

await getRepository(MyEntity)
  .createQueryBuilder('my_entity')
  .where('start <= :today', { today: "2025-06-13" })
  .andWhere('end >= :today OR end IS NULL', { today: "2025-06-13" })
  .getMany();

额外提示 #

你的from方法将数据库的UTC日期转换为伦敦时区的字符串，这会导致实体中的日期与数据库存储的日期存在时区差异，可能引发其他隐性问题。建议尽量保持实体与数据库的日期时区一致，或者在所有日期处理逻辑中明确统一时区规则。

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