NestJS+TypeORM+PostgreSQL创建用户实体遇getEntityValue未定义错误求助

使用NestJS + TypeORM + PostgreSQL开发项目时，尝试创建包含avatar对象（含public_key和url字段）的User实体，错误使用@TreeChildren装饰器关联Avatar实体（意图实现嵌套），在创建用户时（不传入avatar字段）出现错误：

Cannot read properties of undefined (reading 'getEntityValue')

@TreeChildren是TypeORM专门用于树形结构实体层级关联的装饰器（比如分类树、部门树这类父子嵌套场景），完全不适合用来表示User与Avatar这种简单的嵌套属性关联。当avatar字段为undefined时，TypeORM会尝试处理树形关联的内部逻辑，进而触发空指针错误。

根据你的业务需求，提供两种可行的修改方案：

方案1：将Avatar作为JSON字段嵌入User实体（推荐，适合简单嵌套场景） #

如果Avatar不需要单独作为数据库表存在，只是User的一个附属属性，直接用PostgreSQL的JSON类型字段存储最简便：

// 定义Avatar类型（无需@Entity装饰器）
export type Avatar = {
  public_key?: string;
  url?: string;
};

@Entity()
// 移除@Tree装饰器，因为不需要树形结构
export class User {
    @PrimaryGeneratedColumn()
    id: number;
    @Column({ type: "text", nullable: false })
    userName: string;
    @Column({ type: "text", nullable: false })
    email: string;
    @Column({ type: "text", nullable: false })
    firstName: string;
    @Column({ type: "text", nullable: false })
    lastName: string;
    @Column({ type: "text", nullable: false, select: false })
    password: string;
    @Column({ type: "text", nullable: true })
    socket_id: string;
    @Column({ type: "text", nullable: true, select: false })
    otp: string;
    // 修改为JSON类型字段，允许为null
    @Column({ type: 'json', nullable: true })
    avatar: Avatar;
    @Column({ type: "boolean", default: false, nullable: false })
    is_verify: boolean;
    @CreateDateColumn()
    created_at: Date;
    @UpdateDateColumn()
    updated_at: Date;

    @BeforeInsert()
    createUserName() {
        this.userName = uniqid.time()
    }
}

方案2：使用一对一关联（Avatar作为独立数据表） #

如果需要将Avatar单独存储为数据库表，使用TypeORM的@OneToOne关联装饰器：

1. 修改Avatar实体 #

@Entity()
export class Avatar {
    @PrimaryGeneratedColumn()
    id: number;

    @Column({ type: "text", nullable: true })
    public_key: string;

    @Column({ type: "text", nullable: true })
    url: string;

    // 可选：添加反向关联到User
    @OneToOne(() => User, user => user.avatar)
    user: User;
}

2. 修改User实体 #

@Entity()
// 移除@Tree装饰器
export class User {
    @PrimaryGeneratedColumn()
    id: number;
    @Column({ type: "text", nullable: false })
    userName: string;
    @Column({ type: "text", nullable: false })
    email: string;
    @Column({ type: "text", nullable: false })
    firstName: string;
    @Column({ type: "text", nullable: false })
    lastName: string;
    @Column({ type: "text", nullable: false, select: false })
    password: string;
    @Column({ type: "text", nullable: true })
    socket_id: string;
    @Column({ type: "text", nullable: true, select: false })
    otp: string;
    // 一对一关联Avatar，nullable设为true表示可选
    @OneToOne(() => Avatar, { nullable: true, cascade: true })
    @JoinColumn()
    avatar: Avatar;
    @Column({ type: "boolean", default: false, nullable: false })
    is_verify: boolean;
    @CreateDateColumn()
    created_at: Date;
    @UpdateDateColumn()
    updated_at: Date;

    @BeforeInsert()
    createUserName() {
        this.userName = uniqid.time()
    }
}

3. 创建用户的逻辑保持不变 #

不需要传入avatar字段时，原有的控制器代码可以直接使用；如果需要传入avatar，只需在UserInput中添加对应的字段并传入数据即可。

1. 移除所有与树形结构相关的装饰器（@Tree、@TreeChildren）
2. 选择适合的方案修改实体代码
3. 重新运行项目，执行创建用户的接口，不传avatar字段即可正常完成数据插入

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