TypeORM与NestJS实体关系配置问题：实体元数据未找到

下面是针对你遇到的Entity metadata for Record#logs was not found错误的排查和修复方案：

1. 确保实体类添加了@Entity()装饰器 #

这是最容易忽略的核心点，TypeORM必须通过@Entity()装饰器识别实体类，否则无法生成对应的元数据。

正确的SalaryLog实体配置 #

// salary-log.entity.ts
import { Entity, PrimaryGeneratedId, ManyToOne } from 'typeorm';
import { SalaryRecord } from './salary-record.entity';

@Entity() // 必须添加此装饰器
export class SalaryLog {
  @PrimaryGeneratedId()
  id: number;

  @ManyToOne(() => SalaryRecord, (record) => record.logs)
  record!: SalaryRecord;

  // 其他业务字段
}

正确的SalaryRecord实体配置 #

// salary-record.entity.ts
import { Entity, PrimaryGeneratedId, OneToMany } from 'typeorm';
import { SalaryLog } from './salary-log.entity';

@Entity() // 必须添加此装饰器
export class SalaryRecord {
  @PrimaryGeneratedId()
  id: number;

  @OneToMany(() => SalaryLog, (log) => log.record)
  logs!: SalaryLog[];

  // 其他业务字段
}

2. 确认实体类名与模块注册的完全一致 #

你模块中注册的是SalaryLog和SalaryRecord，但代码示例里写的是Log和Record，必须保证类名和注册的实体完全匹配，不能有拼写或命名差异。

3. 检查TypeORM根配置的实体加载规则 #

确保TypeOrmModule.forRoot中配置了正确的实体路径，避免遗漏实体：

// app.module.ts 或数据库配置模块
TypeOrmModule.forRoot({
  type: 'mysql', // 替换为你的数据库类型
  host: 'localhost',
  port: 3306,
  username: 'root',
  password: 'password',
  database: 'your_db',
  entities: [__dirname + '/**/*.entity{.ts,.js}'], // 通配符加载所有实体文件
  synchronize: process.env.NODE_ENV !== 'production', // 生产环境禁用自动同步表结构
}),

4. 确保装饰器元数据配置正确 #

检查tsconfig.json中是否开启了装饰器相关编译配置，这是TypeORM识别实体关系的基础：

{
  "compilerOptions": {
    "experimentalDecorators": true,
    "emitDecoratorMetadata": true,
    // 其他编译配置
  }
}

5. 可选：完善关系配置增强稳定性 #

在@ManyToOne中添加外键相关配置，明确关系约束，同时确保双向绑定逻辑正确：

// salary-log.entity.ts
@ManyToOne(() => SalaryRecord, (record) => record.logs, {
  nullable: false, // 强制Log必须关联一个Record
  onDelete: 'CASCADE', // 删除Record时自动删除关联的Log
})
record!: SalaryRecord;

按照以上步骤排查后，应该能解决元数据找不到的问题。如果依然存在问题，可以尝试删除项目的dist编译目录后重新编译启动。

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