如何通过TypeORM查询MongoDB文档的子属性（如email）？

你原来的写法返回null的核心原因是：TypeORM针对MongoDB的嵌套对象直接使用对象结构查询时，会被解析为匹配整个嵌套对象的完全相等，而你的文档中user.details包含email和username两个字段，仅匹配email的对象无法命中目标文档。

正确的查询方式 #

1. 点符号路径查询（推荐）

这是TypeORM查询MongoDB嵌套字段的标准方式，直接通过字符串键指定嵌套属性的路径：

const emailExists = await this.userRepo.findOneBy({
  "user.details.email": "test@test.ch"
});

2. QueryBuilder实现

如果需要复杂的查询逻辑（多条件组合、排序等），QueryBuilder会更灵活：

const emailExists = await this.userRepo.createQueryBuilder()
  .where("user.details.email = :email", { email: "test@test.ch" })
  .getOne();

关键前提：确保实体类定义正确 #

如果实体类的嵌套结构映射错误，即使查询语法正确也会失败。根据你的文档结构，实体类应这样定义：

import { Entity, ObjectIdColumn, Column } from "typeorm";
import { ObjectId } from "mongodb";

@Entity()
export class MainEntity { // 根据业务需求命名，比如Account或User
  @ObjectIdColumn()
  _id: ObjectId;

  @Column({ type: "object" })
  user: {
    details: {
      email: string;
      username: string;
    };
    status: string;
  };
}

若嵌套结构需复用，可使用@Embedded定义嵌入式实体：

import { Entity, ObjectIdColumn, Column, Embedded } from "typeorm";
import { ObjectId } from "mongodb";

class Details {
  @Column()
  email: string;

  @Column()
  username: string;
}

@Entity()
export class MainEntity {
  @ObjectIdColumn()
  _id: ObjectId;

  @Column({ type: "object" })
  user: {
    @Embedded(() => Details)
    details: Details;
    status: string;
  };
}

更优实现方案 #

• 简单查询场景：优先用点符号路径，写法简洁且性能稳定。
• 复杂查询场景：使用QueryBuilder支持多条件组合、投影、排序等高级操作。
• 性能优化：若email是高频查询字段，可为嵌套属性创建索引：

  @Index(["user.details.email"])
  @Column({ type: "object" })
  user: {
    details: {
      email: string;
      username: string;
    };
    status: string;
  };
  

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