NestJS跨项目调用服务遇EntityMetadataNotFoundError错误求助

问题场景 #

我有个通过GitHub Actions发布的NestJS用户管理项目，在另一个项目里调用它的registerUser服务时，抛出错误：EntityMetadataNotFoundError: No metadata for "User" was found。我已经在数据源配置里引入了从该项目导入的User实体，两个项目的AppModule也都配置了TypeOrmModule.forRoot，模块中同样通过TypeOrmModule.forFeature引入了User实体，怀疑是调用时用的User实体不一致导致的问题。

相关代码如下：

数据源配置 #

export const dataSourceOptions: DataSourceOptions = {
    type: 'mysql',
    host: configService.get('DB_HOST'),
    port: configService.get('DB_PORT'),
    username: configService.get('DB_USERNAME'),
    password: configService.get('DB_PASSWORD'),
    database: configService.get('DB_DATABASE'),
    // entities: ['dist/**/*.entity.js'],
    entities: [User],    
    synchronize: true,
}

User实体代码 #

@Entity()
export class User {

  @PrimaryGeneratedColumn()
  id: number;

  @Column()
  firstName: string;

  @Column()
  lastName: string;

  @Column({ unique: true })
  username: string;

  @Column({ default: null })
  phoneNumber: string;

  email: string;

  @Column({ select: false })
  @Exclude()
  password: string;

  @Exclude()
  confirmPassword: string;
}

解决思路 #

1. 锁死实体引用的一致性 #

跨项目调用时，必须保证两个项目用的是同一个User实体的导出，绝对不能各自定义或者复制一份实体代码。如果用户管理项目是作为npm包发布的，调用方必须直接导入该包中的User实体，本地不能再重新定义。

2. 检查TypeORM元数据的注册逻辑 #

• 确认调用方项目TypeOrmModule.forRoot的entities数组里，导入的User实体和用户管理项目里的是同一个实例。要避免因为文件路径、打包流程导致生成两份User类，TypeORM会把它们当成不同实体，自然找不到元数据。
• 如果用DataSource初始化，要么让调用方和服务方用共享的DataSource配置，要么确保实体元数据被注册到同一个连接里。

3. 排查打包发布的细节 #

因为项目是通过GitHub Actions发布的，要检查发布的npm包是否带了完整的实体元数据：

• 确认User实体的装饰器（@Entity、@Column这些）在打包后没被移除，TypeORM完全依赖这些装饰器生成元数据。
• 检查tsconfig配置，确保emitDecoratorMetadata和experimentalDecorators都设为true，不然编译时会丢失元数据。

4. 避免重复初始化TypeORM连接 #

如果两个项目部署在同一个进程里（比如monorepo结构），只能初始化一次TypeORM连接，不能两个项目各自调用TypeOrmModule.forRoot，否则会创建两个独立的连接，元数据根本没法共享。

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