You need to enable JavaScript to run this app. 集成@golevelup/nestjs-rabbitmq的NestJS服务执行种子脚本后无法退出导致CircleCI超时
优惠活动
大模型
产品
解决方案
定价
更多

集成@golevelup/nestjs-rabbitmq的NestJS服务执行种子脚本后无法退出导致CircleCI超时

问题根因

进程无法退出、触发CircleCI超时的核心原因是RabbitMQ长连接的异步句柄未随应用关闭主动释放,导致Node事件循环始终存在未完成的异步任务,即使执行了app.close()也无法让进程正常终止。
对应到当前代码场景,存在几个明确的触发点:

  • 你在RabbitMQ配置中设置了connectionInitOptions: { wait: false },该配置会跳过RabbitMQ连接的启动等待阶段,应用启动时不会阻塞等待RabbitMQ连接就绪。但@golevelup/nestjs-rabbitmq模块的生命周期钩子没有覆盖这种异步建立的连接:种子脚本启动时,RabbitMQ连接是在后台异步建立的,没有被Nest的应用关闭流程追踪,等种子任务执行完调用app.close()时,这个刚建立的长连接通道仍然挂在事件循环里,无法被自动回收。
  • 本地生产环境运行时感知不到这个问题,是因为长期运行的服务本身不需要主动退出,未释放的句柄不会造成影响。但在数据库种子、CI流水线这类“执行完就需要立即退出”的短生命周期场景下,挂起的RabbitMQ长连接会让进程一直处于“等待异步任务完成”的状态,最终被CI判定为长时间无输出触发10分钟超时。
  • 消费端服务没有出现同类问题,是因为消费端的连接和消费器实例是绑定在Nest生命周期上的,应用关闭时会自动触发消费器的停止逻辑,连带释放连接;而纯生产者的配置下,模块不会自动注册连接关闭的钩子,就会出现句柄泄漏。
修复方案
  1. 手动注册RabbitMQ连接的关闭逻辑
    在自定义的RabbitmqModule中实现OnModuleDestroy钩子,在应用关闭时主动释放RabbitMQ连接,避免句柄残留。修改后的模块代码参考:
    import { Global, Module, OnModuleDestroy, Inject } from '@nestjs/common';
    import { ConfigService } from '@nestjs/config';
    import { RabbitMQModule, RabbitConnection } from '@golevelup/nestjs-rabbitmq';
    import { UserProducer } from './producers/user.producer';
    import { Connection } from 'amqplib';
    
    @Global()
    @Module({
      imports: [
        RabbitMQModule.forRootAsync(RabbitMQModule, {
          useFactory: async (config: ConfigService) => ({
            exchanges: [
              {
                name: config.get('rabbitMQ.exchange'),
                type: config.get('rabbitMQ.exchangeType'),
              },
            ],
            uri: config.get('rabbitMQ.url'),
            connectionInitOptions: { wait: false },
          }),
          inject: [ConfigService],
        }),
      ],
      providers: [UserProducer],
      exports: [UserProducer],
    })
    export class RabbitmqModule implements OnModuleDestroy {
      constructor(@Inject(RabbitConnection) private readonly connection: Connection) {}
    
      async onModuleDestroy() {
        // 模块销毁时主动关闭RabbitMQ连接,释放底层句柄
        if (this.connection) {
          await this.connection.close();
        }
      }
    }
    
  2. 给种子脚本增加强制退出兜底
    针对短生命周期的脚本执行场景,在所有业务逻辑执行完成后增加进程强制退出逻辑,避免第三方库的句柄释放遗漏导致进程卡滞。修改后的种子脚本参考:
    import { NestFactory } from '@nestjs/core';
    import { SeedService } from '../src/database/service/seed.service';
    import { AppModule } from '../src/app/app.module';
    
    async function bootstrap() {
      const app = await NestFactory.createApplicationContext(AppModule);
      try {
        await app.get(SeedService).seed();
        await app.close();
      } catch (error) {
        await app.close();
        // 异常场景下以非0状态码退出
        process.exit(1);
      }
      // 正常执行完成后强制退出,避免事件循环挂起
      process.exit(0);
    }
    
    bootstrap();
    
  3. CI配置适配(可选)
    可以根据实际种子任务的执行时长,适当调整CircleCI的“无输出超时”阈值,避免任务正常运行时被误判超时。

内容的提问来源于stack exchange,提问作者joey

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.08 22:06:02