TypeORM中WHERE条件传undefined匹配全部数据的问题及原生解决办法

TypeORM默认会忽略where条件中值为undefined、null或空对象的属性，这就是你遇到的问题：当id设为undefined时，查询相当于没有指定where条件，findOne会返回表中第一条记录，find则返回全部数据。

以下是TypeORM自身提供的几种处理方式：

1. 设置skipUndefined参数（TypeORM 0.3.x及以上） #

在0.3版本之后，TypeORM新增了skipUndefined查询选项，默认值为true（即忽略undefined条件）。将其设为false后，undefined的条件会被转换为IS NULL的SQL查询，而非直接忽略。

如果你的业务场景中id字段不会存在null值，这样设置后就不会返回任何数据，避免误获取全表数据：

const client = await this.clientRepository.findOne({
  where: {
    id: payload.clientId // undefined
  },
  skipUndefined: false // 禁用忽略undefined条件的默认行为
});

2. 使用SelectQueryBuilder精确控制条件 #

通过查询构建器，你可以手动决定是否添加某个条件，这属于TypeORM原生的查询方式，逻辑更清晰：

const query = this.clientRepository.createQueryBuilder("client");
if (payload.clientId !== undefined) {
  query.where("client.id = :id", { id: payload.clientId });
}
const client = await query.getOne();

当payload.clientId为undefined时，不会添加where条件，此时如果想返回null而非第一条数据，可以额外处理（比如判断如果没有条件就直接返回null）。

3. 用IsNull()表达式明确匹配null #

借助TypeORM内置的IsNull()函数，可以主动将undefined的条件转为匹配null的查询：

import { IsNull } from "typeorm";

const client = await this.clientRepository.findOne({
  where: {
    id: payload.clientId ?? IsNull()
  }
});

同样，如果表中id没有null值，这个查询会返回null，不会误获取数据。

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