使用NestJS队列时关闭Redis连接：Jest E2E测试未退出问题

我之前也碰到过完全一样的问题——明明调用了app.close()，Jest还是卡在那不肯退出，查了半天发现根源就是Bull依赖的ioredis连接没被正确释放。下面是几个不用--forceExit掩盖问题的有效解决思路：

1. 手动关闭指定队列的Redis连接 #

app.close()会关闭Nest的模块上下文，但如果你的Bull队列是动态注册的，或者模块销毁钩子没正确处理队列连接，就需要手动获取队列实例并主动关闭：

// 导入必要依赖
import { getQueueToken } from '@nestjs/bull';
import { Queue } from 'bull';
import { INestApplication } from '@nestjs/common';
import { Test } from '@nestjs/testing';

describe('你的测试套件', () => {
  let app: INestApplication;
  let taskQueue: Queue;

  beforeAll(async () => {
    const moduleFixture = await Test.createTestingModule({
      imports: [
        // 导入你的Bull队列配置
        BullModule.registerQueue({
          name: 'task-queue',
          redis: { /* 你的Redis配置 */ },
        }),
        // 其他业务模块...
      ],
    }).compile();

    app = moduleFixture.createNestApplication();
    await app.init();
    // 通过队列名称获取实例
    taskQueue = app.get<Queue>(getQueueToken('task-queue'));
  });

  afterAll(async () => {
    // 先关闭队列的Redis连接
    await taskQueue.close();
    // 再关闭Nest应用
    await app.close();
  });

  // 你的测试用例...
});

queue.close()会自动关闭底层的ioredis客户端，释放所有关联连接。如果有多个队列，重复这个步骤获取每个队列实例并调用close()即可。

2. 先清理未完成的队列任务 #

如果你的测试触发了队列任务，可能有未完成的任务占用着连接，导致无法正常关闭。这种情况下，需要在关闭队列前先清空或等待任务完成：

afterAll(async () => {
  // 清空队列中所有待处理任务
  await taskQueue.empty();
  // 等待所有正在执行的任务处理完成（按需使用）
  await taskQueue.waitUntilFinished();
  // 再关闭队列和应用
  await taskQueue.close();
  await app.close();
});

3. 全局关闭所有Bull连接（多队列场景适用） #

如果你有大量队列不想逐个手动关闭，可以尝试Bull的全局关闭方法（注意：Bull v4+版本支持Queue.closeAll()）：

import { Queue } from 'bull';

afterAll(async () => {
  // 关闭所有Bull队列的连接
  await Queue.closeAll();
  await app.close();
});

为什么app.close()没用？ #

Nest的app.close()会触发模块的onModuleDestroy钩子，但@nestjs/bull的默认实现对动态注册的队列可能不会自动触发连接关闭逻辑，所以需要我们手动干预，确保Redis连接被彻底释放。

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