Nest+Fastify集成fastify-next与TypeOrm后找不到next()函数如何解决

算力阿峰

2026-10-6

问题根源

问题本质是异步时序冲突：

TypeOrm.forRootAsync的异步初始化拉长了Nest应用初始化周期，同时fastify-next插件内部需要额外异步初始化Next.js运行时，fastify.after()钩子只会等待当前插件注册流程完成，不会等待插件内部异步挂载方法的逻辑执行完成
Nest封装的app.register()返回的实例不是完全的原生fastify实例，部分挂载的方法可能没有同步暴露

标准解决方案

使用fastify官方提供的ready()API替代轮询和after钩子，这个API会等待所有fastify插件（含内部异步逻辑）完全加载完成、所有挂载方法就位后才会resolve，同时直接操作原生fastify实例避免封装层的时序问题，修改后的main.ts代码如下：

async function bootstrap() {
  const app = await NestFactory.create<NestFastifyApplication>(
    AppModule,
    new FastifyAdapter(),
  );

  // 等待所有Nest模块（包括TypeOrm）初始化完成
  await app.init();

  const configService = app.get<ConfigService<IConfigTypes>>(ConfigService);
  const appConfig = configService.get<IAppConfig>('app');

  // 直接获取原生fastify实例
  const fastify = app.getHttpAdapter().getInstance();

  // 注册fastify-next插件
  await fastify.register(fastifyNext, {
    dev: appConfig.isDev,
    dir: appConfig.clientPath,
  });

  // 等待fastify所有插件完全加载，确保next方法已挂载
  await fastify.ready();

  // 直接注册路由，不需要after钩子
  appConfig.staticRoutes.forEach((page) => fastify.next(page));

  await app.listen(appConfig.port);
  Logger.log(`🚀 Server is running on port ${appConfig.port}`, 'Bootstrap');
}
bootstrap();