如何解决NestJS+TypeORM中的EntityMetadataNotFoundError错误？

核心原因分析 #

该错误本质是TypeORM无法通过配置的通配符路径找到实体类文件，或找到的文件因编译路径、元数据配置问题未被正确加载。结合你的场景，以下是针对性解决方案：

解决方案1：使用绝对路径+正确通配符格式 #

手动拼接绝对路径时，需指向编译后实体文件的实际位置（而非源码位置，直接运行ts文件除外）。根据你的目录结构，调整配置如下：

在app.module.ts中配置 #

import { join } from 'path';

TypeOrmModule.forRoot({
    type: 'postgres',
    host: process.env.DATABASE_HOST,
    port: parseInt(process.env.DATABASE_PORT),
    username: process.env.DATABASE_USER,
    password: process.env.DATABASE_PASSWORD,
    database: process.env.DATABASE_NAME,
    entities: [join(__dirname, 'database/entities/**/*.entity.{ts,js}')],
    synchronize: true,
})

注：__dirname在编译后的js文件中指向dist目录对应位置，若tsconfig配置了outDir: 'dist'，编译后dist/app.module.js的__dirname为dist，与dist/database/entities（对应源码database/entities）路径匹配。

在data-source.ts中配置 #

因文件位于database目录下，路径需调整：

import { join } from 'path';
import { DataSource } from 'typeorm';

export const AppDataSource = new DataSource({
    type: 'postgres',
    // ...其他数据库配置
    entities: [join(__dirname, 'entities/**/*.entity.{ts,js}')],
    seeds: [
        './seeds/basicClasses/*{.ts,.js}',
        './seeds/*{.ts,.js}'
    ],
    factories: ['../src/database/factories/**/*{.ts,.js}']
})

解决方案2：检查tsconfig.json关键配置 #

确保以下配置正确，避免编译后实体文件位置错乱或元数据丢失：

{
  "compilerOptions": {
    "module": "commonjs",
    "target": "ES2021",
    "outDir": "./dist",
    "rootDir": "./", // 若源码集中在src目录，改为"./src"
    "emitDecoratorMetadata": true,
    "experimentalDecorators": true,
    "esModuleInterop": true,
    "skipLibCheck": true,
    "forceConsistentCasingInFileNames": true
  }
}

关键项：emitDecoratorMetadata和experimentalDecorators必须设为true，否则TypeORM无法识别@Entity()装饰器的元数据；outDir与rootDir需对应，保证编译后文件结构与源码一致。

解决方案3：适配TypeORM版本差异 #

不同版本的通配符路径格式要求不同：

• TypeORM 0.x：仅需指定编译后的js文件路径，如entities: [__dirname + '/../database/entities/**/*.js']
• TypeORM 1.x+/2.x：支持*.{ts,js}格式，推荐用join方法拼接路径避免跨平台问题

可通过npm list typeorm查看当前版本，对应调整路径格式。

解决方案4：验证实体类导出格式 #

确认每个实体类正确导出，且@Entity()装饰器生效：

import { Entity, Column, PrimaryGeneratedColumn } from 'typeorm';

@Entity()
export class User { // 命名导出或默认导出均可
  @PrimaryGeneratedColumn()
  id: number;

  @Column()
  name: string;
}

验证路径匹配有效性 #

可通过glob工具打印匹配到的文件，确认路径是否正确：

import { glob } from 'glob';
import { join } from 'path';

// 在app.module.ts中添加调试代码
glob(join(__dirname, 'database/entities/**/*.entity.{ts,js}'), (err, files) => {
  if (err) console.error(err);
  else console.log('匹配到的实体文件：', files);
});

若文件列表为空，说明路径配置错误；若有文件但仍报错，需检查元数据生成或TypeORM加载逻辑。

内容的提问来源于stack exchange，提问作者Timothée CLEAR