Jest测试调用pg数据库查询时触发5000ms超时问题

你碰到的超时本质是多运行时实例状态不一致+测试侧数据库客户端未完成初始化，和silBastan方法的写法无关，你之前的排查已经排除了方法本身的逻辑问题，漏了三个核心事实：

• Jest测试进程和你本地启动的Express服务是两个完全独立的Node.js运行时，两边各自require得到的database.js模块是独立副本，内存空间、数据库连接状态完全不共享。你提到的“数据库已完成连接”，仅针对Express服务进程内的pg客户端生效，测试进程里的pg客户端从始至终没建立有效连接。
• pg客户端在未调用connect()建立连接的状态下直接执行query()，部分版本不会直接抛出连接错误，会进入挂起等待状态直到连接建立，这个pending状态的Promise永远不会resolve/reject，直到触发Jest默认的5000ms超时阈值。
• 你把silBastan替换为setTimeout包装的Promise能正常执行、Express路由内调用silBastan不超时，都能佐证这个判断：前者不需要依赖数据库连接，后者用的是Express进程内已经完成初始化的数据库连接，自然不会卡住。

按以下步骤1分钟就能确认问题：

• 在测试文件调用silBastan()之前，打印pg客户端的内部连接状态console.log(client._connected)，运行测试会看到输出为false，确认连接未建立。
• 给silBastan()的调用加.catch(err => console.log(err))，会捕获到数据库连接未初始化、或者连接配置读取错误的具体报错——之前因为没做错误捕获，Promise一直挂起才会触发超时。

根据你的测试场景二选一即可：

1. 测试侧直连数据库清理数据（你当前的写法）
   先补全数据库客户端的初始化逻辑，确保不管是服务进程还是测试进程加载模块时，都能正确建立数据库连接，避免出现未连接就发query的情况：

   // database.js 修正版
   const pg = require("pg");
   // 显式配置连接参数，避免测试环境读错环境变量导致连错地址/端口
   const client = new pg.Client({
     host: process.env.DB_HOST || 'localhost',
     port: process.env.DB_PORT || 5432,
     database: process.env.DB_NAME || '你的业务库名',
     user: process.env.DB_USER || '你的数据库账号',
     password: process.env.DB_PWD || '你的数据库密码'
   });
   // 避免重复调用connect
   if (!client._connected) {
     client.connect().catch(err => {
       console.error('数据库连接初始化失败:', err);
       process.exit(1);
     });
   }
   
   async function silBastan() {
     return client.query(`DELETE FROM account`);
   }
   
   module.exports = { silBastan, client };
   

   如果本地数据库性能一般、删表耗时确实超过5s，可以在测试文件顶部加一行配置调大Jest超时阈值：

   jest.setTimeout(15000); // 单测试用例超时调整为15s
   

2. 接口测试最佳实践（推荐）
   不要让测试代码直连业务数据库做数据准备/清理，避免跨进程连接状态不一致、数据库锁冲突这类问题。可以给测试环境加一个专用的测试重置接口，内部复用服务本身的数据库连接执行清理逻辑：

   // Express 测试专用路由，仅在NODE_ENV为test时加载
   if (process.env.NODE_ENV === 'test') {
     router.post('/test/reset', async (req, res) => {
       await silBastan();
       res.sendStatus(200);
     })
   }
   

   测试用例里不需要直接引入silBastan，直接通过axios调用这个重置接口清理数据即可，完全复用服务侧的已初始化连接，不会出现连接异常。

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