NestJS项目中TypeOrm报错：default连接下未找到已注册的User仓储

• 核心高频问题：未在使用仓储的模块中通过TypeOrmModule.forFeature()注册实体
  • 哪怕在根模块的TypeOrmModule.forRoot()配置中手动引入了User实体，只要需要在某个模块（比如挂载了AuthenticationController的认证模块、存放AdminController的管理模块）注入User仓储，就必须在该模块的imports数组中显式添加TypeOrmModule.forFeature([User])。
  • 纠正对autoLoadEntities配置的误解：该配置的作用是自动把所有在各模块中通过forFeature()注册过的实体，同步挂载到根TypeOrm连接上，完全不具备自动扫描路径下实体、自动生成仓储注入实例的能力。如果从未在任何模块中用forFeature声明过User实体，仅靠根模块entities数组手动引入，Nest的依赖注入容器根本不会生成对应User的仓储实例，自然会抛出找不到仓储的错误。
  • 哪怕现在把AuthenticationController、AuthenticationService直接挂在根AppModule上，也必须在AppModule的imports数组中补充TypeOrmModule.forFeature([User])，否则依赖注入无法匹配到对应的仓储实例。
• 清理entities数组中的无效配置
  • 当前forRoot配置的entities数组中包含BaseEntity，但BaseEntity是未添加@Entity装饰器的抽象基类，仅用于给其他实体继承公共字段，不属于独立的数据库实体，将它放入entities数组属于无效配置，甚至可能干扰TypeOrm的实体加载匹配逻辑，直接移除数组中的BaseEntity即可。
  • 开启autoLoadEntities: true的场景下，完全不需要在forRoot的entities数组中手动罗列实体类，手动列举反而容易出现漏写、错写的问题。
• 校验仓储注入的写法正确性
  • 检查@InjectRepository()装饰器的传参，必须传入项目中导入的User实体类引用，禁止传入字符串形式的类名：
    • 正确写法：constructor(@InjectRepository(User) private userRepo: Repository<User>)
    • 错误写法：constructor(@InjectRepository("User") private userRepo: Repository<User>)
      后者会因依赖注入令牌不匹配，无法定位到对应的仓储实例。
• 通配符自动加载实体的修复方案
  • 如果之前尝试通配符扫描实体未生效，需要注意路径适配编译环境，避免硬编码绝对路径：
    • 开发环境（ts-node运行）：实体路径写为[__dirname + '/**/*.entity{.ts,.js}']
    • 编译后运行（代码输出到dist目录）：上述路径会自动适配，无需额外调整。
  • 注意cli配置项仅作用于typeorm命令行工具（比如执行迁移、生成实体的命令），不影响项目实际运行时的实体加载逻辑，之前配置里拼错的entitiesDir: '/entitys'只要不影响命令行使用，可以暂时忽略。

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