集成@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生命周期上的,应用关闭时会自动触发消费器的停止逻辑,连带释放连接;而纯生产者的配置下,模块不会自动注册连接关闭的钩子,就会出现句柄泄漏。
修复方案
- 手动注册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(); } } } - 给种子脚本增加强制退出兜底
针对短生命周期的脚本执行场景,在所有业务逻辑执行完成后增加进程强制退出逻辑,避免第三方库的句柄释放遗漏导致进程卡滞。修改后的种子脚本参考: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(); - CI配置适配(可选)
可以根据实际种子任务的执行时长,适当调整CircleCI的“无输出超时”阈值,避免任务正常运行时被误判超时。
内容的提问来源于stack exchange,提问作者joey
相关产品推荐
相关产品推荐

