自定义Jest测试环境配置Mongoose连接失败排查（readyState=0）

你想通过自定义Jest环境实现全局一次连接/断开数据库的思路非常合理，测试失败（readyState为0）的核心原因几乎都是自定义环境的生命周期方法没正确处理异步连接逻辑，或者没有把连接实例暴露给测试上下文。下面分点给你排查和解决：

1. 必须正确实现自定义环境的异步setup()和teardown()方法 #

Jest的自定义测试环境需要继承基础环境类（比如NodeEnvironment），并且setup方法必须是异步的——你大概率是没等待数据库连接完成就让测试启动了，导致测试执行时连接还没建立。

举个正确的mongo-environment.js示例：

const NodeEnvironment = require('jest-environment-node').default;
const { MongoClient } = require('mongodb');

class MongoEnvironment extends NodeEnvironment {
  constructor(config) {
    super(config);
  }

  // 关键：用async/await等待连接完成
  async setup() {
    await super.setup();
    try {
      // 等待数据库连接建立完成
      this.global.mongoClient = await MongoClient.connect(process.env.MONGO_URI);
      console.log('✅ 全局数据库连接成功，readyState:', this.global.mongoClient.topology.readyState);
    } catch (err) {
      console.error('❌ 数据库连接失败:', err);
      throw err; // 抛出错误终止测试，避免无意义执行
    }
  }

  // 测试全部结束后断开连接
  async teardown() {
    if (this.global.mongoClient) {
      await this.global.mongoClient.close();
      console.log('✅ 全局数据库连接已断开');
    }
    await super.teardown();
  }

  getVmContext() {
    return super.getVmContext();
  }
}

module.exports = MongoEnvironment;

这里的核心是：setup方法是异步的，必须用await等待MongoClient.connect完成，确保测试启动前连接已经建立。

2. 确保数据库实例暴露到全局测试上下文 #

你需要把连接后的mongoClient挂载到this.global上，这样所有测试文件都能直接访问global.mongoClient（或者你可以封装成更易用的形式）。如果没做这一步，测试里调用的数据库实例可能是未初始化的，自然会出现readyState为0的情况。

3. 验证Jest配置的正确性 #

检查jest.config.js里的testEnvironment路径是否正确：

• 如果mongo-environment.js在项目根目录，./mongo-environment是对的；如果在子目录（比如config/mongo-environment.js），要改成./config/mongo-environment。
• 同时确认项目里没有其他Jest配置（比如package.json中的jest字段）覆盖了这个设置。

4. 排查数据库本身的连接问题 #

如果上面的步骤都做了还是失败，那可能是数据库服务没启动、连接字符串错误或者权限问题：

• 先手动测试连接字符串是否有效，比如用MongoDB Compass连接试试；
• 在setup方法里加上错误捕获，打印详细错误信息，方便定位问题。

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