TypeORM DataSource初始化错误：无法读取undefined的getProperty属性

问题根源 #

1. TypeORM初始化元数据时需要实例化实体类，要求实体必须提供公共无参构造函数，你的Tuition实体使用了私有构造函数且依赖requestDto参数，导致TypeORM无法创建实例，触发requestDto为undefined的错误。
2. 映射数据库字段的属性（id、name、location）被定义为私有，TypeORM无法访问这些属性完成数据库映射。
3. studentIds是未用TypeORM装饰器标记的私有集合属性，TypeORM无法识别该字段，且原生不支持Set类型存储。

修复步骤 #

1. 调整实体构造函数与ID生成逻辑 #

将私有构造函数改为公共无参构造，把业务化的实体创建逻辑移到静态工厂方法中，同时用@BeforeInsert装饰器自动生成带前缀的ID：

2. 修改实体属性访问权限 #

将数据库映射属性改为公共（或受保护），确保TypeORM能正常访问并映射字段。

3. 处理studentIds集合字段 #

TypeORM原生不支持Set类型，改用simple-array类型存储字符串数组，后续业务逻辑中可转换为Set使用。

修改后的完整实体代码 #

import { Entity, PrimaryColumn, Column, BeforeInsert } from "typeorm";
import { randomUUID } from "crypto";

/**
 * Tuition entity
 */
@Entity()
export class Tuition {
    private readonly TUITION_ID_PREFIX: string = "tid-";

    @PrimaryColumn()
    id: string;

    @Column({ nullable: false })
    name: string;

    @Column({ nullable: false })
    location: string;

    @Column("simple-array", { nullable: true })
    private studentIds: string[] = [];

    // 公共无参构造函数，供TypeORM使用
    constructor() {}

    // 静态工厂方法，用于业务侧创建符合规则的实体
    public static create(requestDto: any): Tuition {
        const tuition = new Tuition();
        tuition.name = requestDto.getProperty("NAME");
        tuition.location = requestDto.getProperty("LOCATION");
        return tuition;
    }

    // 插入数据库前自动生成ID
    @BeforeInsert()
    generateId(): void {
        this.id = this.TUITION_ID_PREFIX + randomUUID();
    }

    public getProperty(property: string): any {
        switch (property) {
            case "ID":
                return this.id;
            case "NAME":
                return this.name;
            case "LOCATION":
                return this.location;
            case "STUDENT_IDS":
                return new Set(this.studentIds);
            default:
                return null;
        }
    }

    public addStudentId(studentId: string): void {
        if (!this.studentIds.includes(studentId)) {
            this.studentIds.push(studentId);
        }
    }

    public removeStudentId(studentId: string): void {
        this.studentIds = this.studentIds.filter(id => id !== studentId);
    }
}

额外优化：数据源初始化改为异步等待 #

确保数据源初始化完成后再启动后续服务逻辑，避免出现未就绪的问题：

import { Application } from "express";
import { MySQLDataSource } from "./path-to-your-datasource-config";
import { TuitionController } from "./path-to-your-controller";
import express from "express";

module.exports = async (app: Application) => {
    try {
        // 等待数据源初始化完成
        await MySQLDataSource.initialize();
        console.log("MySQL Datasource has been successfully initialized");
    } catch (e) {
        console.error("Error initializing mysql datasource", e);
        // 初始化失败时可以选择退出进程
        process.exit(1);
    }
    
    app.use(express.json());
    TuitionController(app);
}

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