NestJS中使用TypeORM的findOneBy时出现TypeScript错误

问题场景 #

基于NestJS+TypeORM构建项目，已配置User和Feed实体的关联关系，但在FeedsService的update方法中查询属于当前用户的Feed时，遇到TypeScript类型错误。

相关代码 #

User实体

@Entity('users')
export class User {
  // ...

  @OneToMany(() => Report, (report) => report.user)
  reports: Report[];

  @OneToMany(() => Feed, (feed) => feed.user)
  feeds: Feed[];
}

Feed实体

@Entity('feeds')
export class Feed {
  // ...

  @ManyToOne(() => User, (user) => user.feeds)
  @JoinColumn({
    name: 'user_id',
  })
  user: User;
}

FeedsService中的报错代码

@Injectable()
export class FeedsService {
  constructor(@InjectRepository(Feed) private repo: Repository<Feed>) {}

async update(
    id: number,
    updateFeedDto: UpdateFeedDto,
    user: User,
    attachment?: Express.Multer.File,
  ) {
    // 查询属于当前用户的feed
    const feed = await this.repo.findOneBy({
      id,
      user: user,
      //^^ TS2322: Type 'User' is not assignable to type 'boolean | FindOperator<any> |
      // FindOptionsWhere<User> | FindOptionsWhere<User>[] | EqualOperator<User> | undefined'.
      // Type 'User' is not assignable to type 'FindOptionsWhere<User>'.
      // Types of property 'reports' are incompatible.
      // Type 'Report[]' is not assignable to type 'boolean | FindOperator<any> |
      // FindOptionsWhere<Report> | FindOptionsWhere<Report>[] | EqualOperator<Report> | undefined'
    });

    // 后续执行更新操作
  }
}

错误原因 #

TypeORM的findOneBy方法要求查询条件必须符合FindOptionsWhere类型规范：关联字段的查询值只能是单个字段的条件对象、FindOperator（如Equal）或主键值，不能直接传入完整的实体对象。

直接传入user: user时，TS会校验User实体的结构——实体中的reports、feeds是数组类型，而FindOptionsWhere<User>不允许数组作为查询条件，因此触发类型不兼容报错。

解决方法 #

以下三种方法都可以解决这个问题，按需选择：

1. 使用关联实体的主键字段查询（ORM风格） #

只传入User实体的主键（通常是id）作为查询条件，符合TypeORM的关联查询规范：

const feed = await this.repo.findOneBy({
  id,
  user: { id: user.id } // 仅用User的主键id构建查询条件
});

2. 直接使用数据库列名查询 #

因为Feed实体中通过@JoinColumn指定了关联字段为user_id，可以直接用数据库字段名查询，更简洁：

const feed = await this.repo.findOneBy({
  id,
  user_id: user.id // 直接使用数据库表中的关联字段名
});

3. 使用TypeORM的Equal操作符 #

通过Equal操作符明确匹配实体引用，适合需要直接关联实体对象的场景（需导入Equal）：

import { Equal } from 'typeorm';

// ...

const feed = await this.repo.findOneBy({
  id,
  user: Equal(user)
});

内容的提问来源于stack exchange，提问作者Md. A. A. Apu