NestJS+TypeORM存储数据报错：未找到KYCStatus元数据

出现No metadata for "KYCStatus" was found错误，本质是TypeORM无法找到对应实体的元数据，以下是具体原因和解决办法：

1. 实体未被数据源注册 #

TypeORM的数据源配置中，entities数组必须包含所有需要使用的实体。检查你的BasicEntitiesArray，确保它已经导入并包含KYCStatus：

// 示例：确保BasicEntitiesArray包含KYCStatus
import { KYCStatus } from '@app/common-lib/entities';
export const BasicEntitiesArray = [
  KYCStatus,
  // 其他实体...
];

2. 实体引用不一致 #

如果项目中存在多个同名的KYCStatus类（比如不同路径下重复定义），或者导入路径错误，会导致注入的Repository对应的实体和数据源注册的实体不是同一个引用。

• 验证所有导入KYCStatus的地方路径一致，比如都是@app/common-lib/entities下的导出
• 可以在实体文件和KYC模块中打印console.log(KYCStatus)，检查输出的类引用是否相同

3. NestJS与手动创建的DataSource不兼容 #

你手动创建了DataSource实例，但NestJS的TypeOrmModule默认会管理自己的数据源上下文，两者分离会导致元数据不共享。

解决方式： #

方案一：改用NestJS的TypeOrmModule.forRoot配置数据源

在根模块（如AppModule）中使用TypeOrmModule.forRoot替代手动创建DataSource，Nest会自动处理元数据和Repository注入：

import { Module } from '@nestjs/common';
import { TypeOrmModule } from '@nestjs/typeorm';
import { KYCModule } from './kyc/kyc.module';
import { BasicEntitiesArray } from './entities';

@Module({
  imports: [
    TypeOrmModule.forRoot({
      type: 'mysql',
      host: '127.0.0.1',
      port: 3306,
      username: 'user',
      password: 'pass',
      database: 'db',
      entities: BasicEntitiesArray,
      migrationsTableName: 'migrations_history',
      logging: true,
    }),
    KYCModule,
  ],
})
export class AppModule {}

方案二：将手动创建的DataSource提供给Nest

如果必须保留手动创建的DataSource，需要将其注入到Nest的依赖容器中：

// database.module.ts
import { Module } from '@nestjs/common';
import { DataSource } from 'typeorm';
import typeOrmConfig from './typeorm-configuration';

@Module({
  providers: [
    {
      provide: DataSource,
      useFactory: async () => {
        const dataSource = typeOrmConfig;
        await dataSource.initialize();
        return dataSource;
      },
    },
  ],
  exports: [DataSource],
})
export class DatabaseModule {}

然后在KYCModule的imports中添加DatabaseModule。

4. 额外注意：异步方法未等待 #

你的webhook控制器方法没有等待handleEvent的异步操作，虽然不是元数据错误的直接原因，但可能引发后续问题，建议修正：

@Post('/webhook')
async webhook(@Body() applicantReviewedDto: ApplicantCreatedDTO){
  await this.kycService.handleEvent(applicantReviewedDto);
}

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