NestJS集成TypeORM重构后报CommentRepository未注册错误排查

报错的核心原因是TypeORM没有成功加载Comment实体，直接诱因有3个：

• 实体匹配的相对路径配置错误：config.service.ts位于config/database/postgres目录下，配置的../../models/**/entities/*.entity.{ts,js}路径向上仅回溯到config目录层级，根本访问不到平级的models目录，glob规则匹配不到任何实体文件。
• 配置冲突：同时开启autoLoadEntities: true和手动glob扫描实体时，autoLoadEntities不会主动扫描磁盘文件，只会加载通过TypeOrmModule.forFeature()注册过的实体，两边规则不匹配就会出现实体漏注册。
• 自定义Repository写法不兼容：如果用的是TypeORM 0.3.x以上版本，旧版@EntityRepository()装饰器的写法已经废弃，写法不对也会报找不到仓库的错。
  另外你写在return语句后的console.log是死代码，永远不会执行。

1. 用绝对路径替换相对路径，彻底避免路径匹配问题 #

不要写脆弱的相对路径，用Node原生path模块结合__dirname拼接绝对路径，不受执行目录影响：
首先在config.service.ts顶部引入path模块：

import * as path from 'path';

修改entities、migrations相关配置：

createTypeOrmOptions(): TypeOrmModuleOptions {
  // 要打日志就写在return前面
  // console.log(this.configService.get<string>('DB_HOST'));
  return {
    type: 'postgres',
    host: this.configService.get<string>('DB_HOST'),
    port: this.configService.get<string>('DB_PORT'),
    username: this.configService.get<string>('DB_USERNAME'),
    password: this.configService.get<string>('DB_PASSWORD'),
    database: this.configService.get<string>('DB_DATABASE'),
    // 路径回溯3级到源码/编译产物根目录，再匹配models下的实体文件
    // 如果你的实体直接放在各model子目录下，就去掉路径里的/entities段
    entities: [path.join(__dirname, '../../../models/**/entities/*.entity.{ts,js}')],
    synchronize: true,
    // 用glob扫实体就先关掉autoLoadEntities避免冲突
    autoLoadEntities: false,
    migrations: [path.join(__dirname, '../../../database/migrations/*.{ts,js}')],
    migrationsRun: true,
    cli: {
      migrationsDir: path.join(__dirname, '../../../database/migrations'),
    },
  };
}

2. 二选一确定实体加载方式 #

• 如果你想靠glob自动扫实体：保持上面的配置，确认autoLoadEntities设为false，不需要在业务模块里额外注册实体。
• 如果你想用autoLoadEntities特性：删掉entities字段的glob配置，在每个模型对应的业务模块里用TypeOrmModule.forFeature([CommentEntity])注册对应实体即可，这种方式更稳定，不会出现路径匹配问题。

3. 修正自定义Repository写法（TypeORM 0.3.x+版本适用） #

旧版装饰器写法已经废弃，按如下方式写自定义仓库：

import { DataSource, Repository } from 'typeorm';
import { Comment } from './comment.entity';
import { Injectable } from '@nestjs/common';

@Injectable()
export class CommentRepository extends Repository<Comment> {
  constructor(private dataSource: DataSource) {
    super(Comment, dataSource.createEntityManager());
  }
  // 这里写你的自定义查询方法
}

然后在Comment对应的模块里注册、导出仓库：

@Module({
  imports: [TypeOrmModule.forFeature([Comment])],
  providers: [CommentRepository],
  exports: [CommentRepository],
})
export class CommentModule {}

需要用仓库的地方直接注入CommentRepository即可，不需要额外注册。

改完配置重启项目，查看启动日志里TypeORM输出的已注册实体列表，确认Comment实体在列表中，报错就会消失。

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