如何为Jest中所有测试创建单一Knex连接池并解决跨Describe测试的执行异常问题

我之前也踩过类似的坑，核心问题就是多个describe作用域下重复创建Knex连接池，再加上Jest的模块加载特性，导致不同测试拿到的不是同一个连接实例，进而beforeEach的脚本无法保证在每个测试前都正确执行。下面是我验证过的可行解决方案：

1. 把Knex连接改成单例模式 #

首先要确保整个测试环境中只有一个Knex连接池实例，避免每次import都新建连接。修改你的global-setup.ts，用单例模式封装连接：

import knex from 'knex';
import testConfig from './knexfile.test.ts'; // 你的测试环境Knex配置

// 用变量缓存连接实例
let knexInstance: knex.Knex | null = null;

// 导出获取单例连接的方法
export const getKnex = () => {
  if (!knexInstance) {
    knexInstance = knex(testConfig);
    // 可以在这里提前执行全局初始化，比如检查表结构是否存在
    knexInstance.raw('CREATE TABLE IF NOT EXISTS users (id SERIAL PRIMARY KEY, name VARCHAR(255))');
  }
  return knexInstance;
};

// 导出全局销毁连接的方法，用于测试结束后清理
export const closeKnex = async () => {
  if (knexInstance) {
    await knexInstance.destroy();
    knexInstance = null;
  }
};

2. 用Jest全局生命周期钩子统一管理 #

不要在每个describe里单独写beforeEach/afterEach，而是用Jest的全局钩子来统一处理连接和数据重置，这样所有测试都会共享同一套逻辑。

创建一个jest.setup.ts文件（需要在jest.config.ts里配置setupFilesAfterEnv: ['./jest.setup.ts']）：

import { getKnex, closeKnex } from './global-setup.ts';

// 所有测试开始前，只初始化一次连接
beforeAll(async () => {
  await getKnex();
});

// 所有测试结束后，关闭连接池
afterAll(async () => {
  await closeKnex();
});

// 每个测试执行前，重置数据库数据（比如清空表）
beforeEach(async () => {
  const knex = getKnex();
  // 根据你的表结构调整，这里示例清空users表并重置自增ID
  await knex.raw('TRUNCATE TABLE users RESTART IDENTITY CASCADE');
});

// 可选：每个测试结束后做额外清理（比如删除临时数据）
afterEach(async () => {
  // 按需添加逻辑
});

3. 修改测试文件的连接引用方式 #

在所有测试文件里，不再直接import连接，而是调用getKnex()获取单例实例：

import { getKnex } from './global-setup.ts';

describe('User Service Tests', () => {
  it('should create a new user', async () => {
    const knex = getKnex();
    await knex('users').insert({ name: 'Test User' });
    
    const users = await knex('users').select('*');
    expect(users).toHaveLength(1);
    expect(users[0].name).toBe('Test User');
  });
});

describe('Another Test Suite', () => {
  it('should return empty users list initially', async () => {
    const knex = getKnex();
    const users = await knex('users').select('*');
    expect(users).toHaveLength(0);
  });
});

关键注意点 #

• 异步操作必须await：所有涉及数据库的钩子（beforeAll、beforeEach等）一定要加await，否则测试会在数据库操作完成前执行，导致数据不一致。
• 内存数据库特殊处理：如果用的是SQLite内存模式，必须保证所有测试用的是同一个连接——不同连接会对应不同的内存数据库，这是很多人踩坑的点。
• Jest模块缓存：Jest默认会缓存模块，所以单例模式的getKnex()只会在第一次调用时创建连接，后续调用都会复用同一个实例，不用担心重复初始化。

这样调整后，不管有多少个describe作用域，所有测试都会共用同一个Knex连接池，而且每个测试前都会执行数据重置脚本，测试结果就会稳定一致了。

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