在 Node.js 服务里用 `pg` 库连接 PostgreSQL 时，很多人会直接在接口末尾调用 `client.end()`，或者把 `pool` 丢在全局不管。本地跑起来一切正常，部署到 Docker 或 PM2 后却经常遇到进程无法退出、连接数持续增长、数据库侧看到大量 idle 连接的问题。这通常是因为没有区分 `client` 和 `pool` 的生命周期：`pool` 内部维护着空闲连接，进程退出时不会自动释放；而在请求作用域中反复 `new Pool()` 更会让连接数失控。下面从实际代码出发，梳理在脚本、Express 服务和测试中如何正确关闭连接，以及如何用事件监听定位泄漏。

## 一个典型的连接泄漏场景

假设有一个定时任务脚本，每次执行时创建一个新的 Pool，查询完只调用 `pool.end()` 但忘了等待 Promise 完成，或者干脆只结束了 client：

```js
const { Pool } = require('pg');

async function runReport() {
 const pool = new Pool({ connectionString: process.env.DATABASE_URL });
 const { rows } = await pool.query('select count(*) from orders');
 console.log(rows[0].count);
 pool.end(); // 没有 await
}

runReport();
```

`pool.end()` 返回 Promise，不 await 的话主流程可能先结束，但底层 socket 还在关闭中，Node 进程会等到所有 handle 释放才退出。更隐蔽的情况是：脚本里用 `pool.connect()` 拿到 client 后忘记 `client.release()`，这个连接会一直标记为 busy，Pool 默认 `max` 是 10，达到上限后新的 `connect()` 会一直排队直到超时。

如果是在 Express 里每个请求都 `new Pool()`，连接数会随 QPS 线性上涨，PostgreSQL 的 `max_connections` 很快被打满，报错 `sorry, too many clients already`。

## Pool 和 Client 的边界

`pg` 的 Pool 是一个连接容器，它自己管理连接的创建、复用和销毁。`pool.query()` 是语法糖：从池里取一个 client，执行查询，然后自动 release。只有需要事务或者多条语句共享同一个 session 时，才需要手动 `pool.connect()`。

```js
// 自动取还，适合单条查询
const { rows } = await pool.query('select * from users where id = $1', [id]);

// 手动管理，适合事务
const client = await pool.connect();
try {
 await client.query('begin');
 await client.query('update accounts set balance = balance - $1 where id = $2', [100, fromId]);
 await client.query('update accounts set balance = balance + $1 where id = $2', [100, toId]);
 await client.query('commit');
} catch (err) {
 await client.query('rollback');
 throw err;
} finally {
 client.release(); // 必须放在 finally
}
```

`client.release()` 如果传入 `true`，会销毁这个连接而不是放回池里，适合连接已经处于异常状态时使用。

## 关闭 Pool 的正确姿势

`pool.end()` 会等待所有已借出的 client 归还，然后关闭空闲连接。在脚本里应该 await 它：

```js
async function main() {
 const pool = new Pool({ connectionString: process.env.DATABASE_URL });
 try {
 const { rows } = await pool.query('select now()');
 console.log(rows[0]);
 } finally {
 await pool.end();
 }
}

main().catch((err) => {
 console.error(err);
 process.exitCode = 1;
});
```

在 Express 这类长期运行的服务里，Pool 应该在应用启动时创建一次，进程退出信号里关闭：

```js
const express = require('express');
const { Pool } = require('pg');

const app = express();
const pool = new Pool({
 connectionString: process.env.DATABASE_URL,
 max: 20,
 idleTimeoutMillis: 30000,
 connectionTimeoutMillis: 5000,
});

app.get('/health', async (req, res) => {
 const { rows } = await pool.query('select 1 as ok');
 res.json(rows[0]);
});

const server = app.listen(3000);

async function shutdown(signal) {
 console.log(`${signal} received, closing`);
 server.close(async () => {
 await pool.end();
 process.exit(0);
 });
}

process.on('SIGTERM', () => shutdown('SIGTERM'));
process.on('SIGINT', () => shutdown('SIGINT'));
```

注意 `server.close()` 只停止接收新连接，已有请求还会继续。加上 `pool.end()` 之后，进程才能干净退出。如果用了 PM2 或 Kubernetes，SIGTERM 是默认的停止信号，这个处理能减少滚动更新时被强杀的概率。

## 监听连接事件定位泄漏

开发阶段可以给 Pool 加上事件监听，观察连接借还是否平衡：

```js
pool.on('connect', () => console.log('new client connected'));
pool.on('acquire', () => console.log('client acquired'));
pool.on('remove', () => console.log('client removed'));
pool.on('error', (err) => console.error('idle client error', err));
```

`pool.on('error')` 特别重要：空闲连接被数据库单方面断开（比如被 pgBouncer 或防火墙 kill）时，错误不会冒泡到 query 的 Promise，而是通过这个事件抛出。没有监听的话，Node 会把它当成 uncaughtException，进程直接挂掉。

也可以给 client 加 `idle` 事件，结合 `pg_stat_activity` 对比：

```sql
select pid, state, query_start, application_name
from pg_stat_activity
where datname = current_database();
```

如果 `state = 'idle'` 且数量接近 Pool 的 `max`，说明有客户端借了没还。

## 测试环境里的清理

用 Jest 或 Vitest 写数据库集成测试时，最容易忘记关闭 Pool，导致测试进程不退出，CI 里表现为卡住直到超时。可以在 `afterAll` 里显式关闭：

```js
let pool;

beforeAll(() => {
 pool = new Pool({ connectionString: process.env.TEST_DATABASE_URL });
});

afterAll(async () => {
 await pool.end();
});
```

如果每个测试文件都建 Pool，记得在各自的 `afterAll` 里关掉，避免多个 Pool 同时挂着连接。

## 一个容易忽略的细节

`connectionTimeoutMillis` 默认是 0，也就是无限等待。当池里连接耗尽时，新的 `connect()` 不会报错，而是一直 pending，表现为接口挂起。生产环境建议设一个合理的值（比如 5000），让调用方能在超时后快速失败，配合日志发现连接池配置是否够用。

同样的，`idleTimeoutMillis` 默认 10000，空闲连接超过这个时间会被关闭。如果数据库侧有更短的 idle 超时或网络设备会断开空闲 TCP，把这个值设得比对方小，能减少 `pool.on('error')` 里遇到的“连接已断开”错误。

数据库连接不是随手 `new` 出来就完事的对象，它的生命周期和进程、请求、测试用例都绑在一起。把 Pool 当作需要显式关闭的资源来管理，能省掉很多“本地能跑、上线就挂”的排查时间。

 推荐查看天气：https://www.0dtq.com/minfeng/zuotian.html
 推荐查看天气：https://www.0dtq.com/minfeng/7tian.html
 推荐查看天气：https://www.0dtq.com/minfeng/10tian.html
 推荐查看天气：https://www.0dtq.com/minfeng/15tian.html
 推荐查看天气：https://www.0dtq.com/minfeng/40tian.html
 推荐查看天气：https://www.0dtq.com/yili/
 推荐查看天气：https://www.0dtq.com/yili/zuotian.html
 推荐查看天气：https://www.0dtq.com/yili/7tian.html
 推荐查看天气：https://www.0dtq.com/yili/10tian.html
 推荐查看天气：https://www.0dtq.com/yili/15tian.html
 推荐查看天气：https://www.0dtq.com/yili/40tian.html
 推荐查看天气：https://www.0dtq.com/yining/
 推荐查看天气：https://www.0dtq.com/yining/zuotian.html
 推荐查看天气：https://www.0dtq.com/yining/7tian.html
 推荐查看天气：https://www.0dtq.com/yining/10tian.html
 推荐查看天气：https://www.0dtq.com/yining/15tian.html
 推荐查看天气：https://www.0dtq.com/yining/40tian.html
 推荐查看天气：https://www.0dtq.com/kuitun/
 推荐查看天气：https://www.0dtq.com/kuitun/zuotian.html
 推荐查看天气：https://www.0dtq.com/kuitun/7tian.html
 推荐查看天气：https://www.0dtq.com/kuitun/10tian.html
 推荐查看天气：https://www.0dtq.com/kuitun/15tian.html
 推荐查看天气：https://www.0dtq.com/kuitun/40tian.html
 推荐查看天气：https://www.0dtq.com/yiningxian/
 推荐查看天气：https://www.0dtq.com/yiningxian/zuotian.html
 推荐查看天气：https://www.0dtq.com/yiningxian/7tian.html
 推荐查看天气：https://www.0dtq.com/yiningxian/10tian.html
 推荐查看天气：https://www.0dtq.com/yiningxian/15tian.html
 推荐查看天气：https://www.0dtq.com/yiningxian/40tian.html
 推荐查看天气：https://www.0dtq.com/chabuchaer/
 推荐查看天气：https://www.0dtq.com/chabuchaer/zuotian.html
 推荐查看天气：https://www.0dtq.com/chabuchaer/7tian.html
 推荐查看天气：https://www.0dtq.com/chabuchaer/10tian.html
 推荐查看天气：https://www.0dtq.com/chabuchaer/15tian.html
 推荐查看天气：https://www.0dtq.com/chabuchaer/40tian.html
 推荐查看天气：https://www.0dtq.com/huocheng/
 推荐查看天气：https://www.0dtq.com/huocheng/zuotian.html
 推荐查看天气：https://www.0dtq.com/huocheng/7tian.html
 推荐查看天气：https://www.0dtq.com/huocheng/10tian.html
 推荐查看天气：https://www.0dtq.com/huocheng/15tian.html
 推荐查看天气：https://www.0dtq.com/huocheng/40tian.html
 推荐查看天气：https://www.0dtq.com/gongliu/
 推荐查看天气：https://www.0dtq.com/gongliu/zuotian.html
 推荐查看天气：https://www.0dtq.com/gongliu/7tian.html
 推荐查看天气：https://www.0dtq.com/gongliu/10tian.html
 推荐查看天气：https://www.0dtq.com/gongliu/15tian.html
 推荐查看天气：https://www.0dtq.com/gongliu/40tian.html
 推荐查看天气：https://www.0dtq.com/xinyuan/
 推荐查看天气：https://www.0dtq.com/xinyuan/zuotian.html
 推荐查看天气：https://www.0dtq.com/xinyuan/7tian.html
 推荐查看天气：https://www.0dtq.com/xinyuan/10tian.html
 推荐查看天气：https://www.0dtq.com/xinyuan/15tian.html
 推荐查看天气：https://www.0dtq.com/xinyuan/40tian.html
 推荐查看天气：https://www.0dtq.com/zhaosu/
 推荐查看天气：https://www.0dtq.com/zhaosu/zuotian.html
 推荐查看天气：https://www.0dtq.com/zhaosu/7tian.html
 推荐查看天气：https://www.0dtq.com/zhaosu/10tian.html
 推荐查看天气：https://www.0dtq.com/zhaosu/15tian.html
 推荐查看天气：https://www.0dtq.com/zhaosu/40tian.html
 推荐查看天气：https://www.0dtq.com/tekesi/
 推荐查看天气：https://www.0dtq.com/tekesi/zuotian.html
 推荐查看天气：https://www.0dtq.com/tekesi/7tian.html
 推荐查看天气：https://www.0dtq.com/tekesi/10tian.html
 推荐查看天气：https://www.0dtq.com/tekesi/15tian.html
 推荐查看天气：https://www.0dtq.com/tekesi/40tian.html
 推荐查看天气：https://www.0dtq.com/nileke/
 推荐查看天气：https://www.0dtq.com/nileke/zuotian.html
 推荐查看天气：https://www.0dtq.com/nileke/7tian.html
 推荐查看天气：https://www.0dtq.com/nileke/10tian.html
 推荐查看天气：https://www.0dtq.com/nileke/15tian.html
 推荐查看天气：https://www.0dtq.com/nileke/40tian.html
 推荐查看天气：https://www.0dtq.com/tachengdiqu/
 推荐查看天气：https://www.0dtq.com/tachengdiqu/zuotian.html
 推荐查看天气：https://www.0dtq.com/tachengdiqu/7tian.html
 推荐查看天气：https://www.0dtq.com/tachengdiqu/10tian.html
 推荐查看天气：https://www.0dtq.com/tachengdiqu/15tian.html
 推荐查看天气：https://www.0dtq.com/tachengdiqu/40tian.html
 推荐查看天气：https://www.0dtq.com/wusu/
 推荐查看天气：https://www.0dtq.com/wusu/zuotian.html
 推荐查看天气：https://www.0dtq.com/wusu/7tian.html
 推荐查看天气：https://www.0dtq.com/wusu/10tian.html
 推荐查看天气：https://www.0dtq.com/wusu/15tian.html
 推荐查看天气：https://www.0dtq.com/wusu/40tian.html
 推荐查看天气：https://www.0dtq.com/emin/
 推荐查看天气：https://www.0dtq.com/emin/zuotian.html
 推荐查看天气：https://www.0dtq.com/emin/7tian.html
 推荐查看天气：https://www.0dtq.com/emin/10tian.html
 推荐查看天气：https://www.0dtq.com/emin/15tian.html
 推荐查看天气：https://www.0dtq.com/emin/40tian.html
 推荐查看天气：https://www.0dtq.com/shawan/
 推荐查看天气：https://www.0dtq.com/shawan/zuotian.html
 推荐查看天气：https://www.0dtq.com/shawan/7tian.html
 推荐查看天气：https://www.0dtq.com/shawan/10tian.html
 推荐查看天气：https://www.0dtq.com/shawan/15tian.html
 推荐查看天气：https://www.0dtq.com/shawan/40tian.html
 推荐查看天气：https://www.0dtq.com/tuoli/
 推荐查看天气：https://www.0dtq.com/tuoli/zuotian.html
 推荐查看天气：https://www.0dtq.com/tuoli/7tian.html
 推荐查看天气：https://www.0dtq.com/tuoli/10tian.html
 推荐查看天气：https://www.0dtq.com/tuoli/15tian.html
 推荐查看天气：https://www.0dtq.com/tuoli/40tian.html
 推荐查看天气：https://www.0dtq.com/yumin/
 推荐查看天气：https://www.0dtq.com/yumin/zuotian.html
 推荐查看天气：https://www.0dtq.com/yumin/7tian.html
 推荐查看天气：https://www.0dtq.com/yumin/10tian.html
 推荐查看天气：https://www.0dtq.com/yumin/15tian.html
 推荐查看天气：https://www.0dtq.com/yumin/40tian.html
 推荐查看天气：https://www.0dtq.com/hebukesaierxian/
 推荐查看天气：https://www.0dtq.com/hebukesaierxian/zuotian.html
 推荐查看天气：https://www.0dtq.com/hebukesaierxian/7tian.html
 推荐查看天气：https://www.0dtq.com/hebukesaierxian/10tian.html
 推荐查看天气：https://www.0dtq.com/hebukesaierxian/15tian.html
 推荐查看天气：https://www.0dtq.com/hebukesaierxian/40tian.html
 推荐查看天气：https://www.0dtq.com/aletai/
 推荐查看天气：https://www.0dtq.com/aletai/zuotian.html
 推荐查看天气：https://www.0dtq.com/aletai/7tian.html
 推荐查看天气：https://www.0dtq.com/aletai/10tian.html
 推荐查看天气：https://www.0dtq.com/aletai/15tian.html
 推荐查看天气：https://www.0dtq.com/aletai/40tian.html
 推荐查看天气：https://www.0dtq.com/buerjin/
 推荐查看天气：https://www.0dtq.com/buerjin/zuotian.html
 推荐查看天气：https://www.0dtq.com/buerjin/7tian.html
 推荐查看天气：https://www.0dtq.com/buerjin/10tian.html
 推荐查看天气：https://www.0dtq.com/buerjin/15tian.html
 推荐查看天气：https://www.0dtq.com/buerjin/40tian.html
 推荐查看天气：https://www.0dtq.com/fuyun/
 推荐查看天气：https://www.0dtq.com/fuyun/zuotian.html
 推荐查看天气：https://www.0dtq.com/fuyun/7tian.html
 推荐查看天气：https://www.0dtq.com/fuyun/10tian.html
 推荐查看天气：https://www.0dtq.com/fuyun/15tian.html
 推荐查看天气：https://www.0dtq.com/fuyun/40tian.html
 推荐查看天气：https://www.0dtq.com/fuhai/
 推荐查看天气：https://www.0dtq.com/fuhai/zuotian.html
 推荐查看天气：https://www.0dtq.com/fuhai/7tian.html
 推荐查看天气：https://www.0dtq.com/fuhai/10tian.html
 推荐查看天气：https://www.0dtq.com/fuhai/15tian.html
 推荐查看天气：https://www.0dtq.com/fuhai/40tian.html
 推荐查看天气：https://www.0dtq.com/habahe/
 推荐查看天气：https://www.0dtq.com/habahe/zuotian.html
 推荐查看天气：https://www.0dtq.com/habahe/7tian.html
 推荐查看天气：https://www.0dtq.com/habahe/10tian.html
 推荐查看天气：https://www.0dtq.com/habahe/15tian.html
 推荐查看天气：https://www.0dtq.com/habahe/40tian.html
 推荐查看天气：https://www.0dtq.com/qinghe/
 推荐查看天气：https://www.0dtq.com/qinghe/zuotian.html
 推荐查看天气：https://www.0dtq.com/qinghe/7tian.html
 推荐查看天气：https://www.0dtq.com/qinghe/10tian.html
 推荐查看天气：https://www.0dtq.com/qinghe/15tian.html
 推荐查看天气：https://www.0dtq.com/qinghe/40tian.html
 推荐查看天气：https://www.0dtq.com/jimunai/
 推荐查看天气：https://www.0dtq.com/jimunai/zuotian.html
 推荐查看天气：https://www.0dtq.com/jimunai/7tian.html
 推荐查看天气：https://www.0dtq.com/jimunai/10tian.html
 推荐查看天气：https://www.0dtq.com/jimunai/15tian.html
 推荐查看天气：https://www.0dtq.com/jimunai/40tian.html
 推荐查看天气：https://www.0dtq.com/xianggang/
 推荐查看天气：https://www.0dtq.com/xianggang/zuotian.html
 推荐查看天气：https://www.0dtq.com/xianggang/7tian.html
 推荐查看天气：https://www.0dtq.com/xianggang/10tian.html
 推荐查看天气：https://www.0dtq.com/xianggang/15tian.html
 推荐查看天气：https://www.0dtq.com/xianggang/40tian.html
 推荐查看天气：https://www.0dtq.com/aomen/
 推荐查看天气：https://www.0dtq.com/aomen/zuotian.html
 推荐查看天气：https://www.0dtq.com/aomen/7tian.html
 推荐查看天气：https://www.0dtq.com/aomen/10tian.html
 推荐查看天气：https://www.0dtq.com/aomen/15tian.html
 推荐查看天气：https://www.0dtq.com/aomen/40tian.html
 推荐查看天气：https://www.0dtq.com/shihezi/
 推荐查看天气：https://www.0dtq.com/shihezi/zuotian.html
 推荐查看天气：https://www.0dtq.com/shihezi/7tian.html
 推荐查看天气：https://www.0dtq.com/shihezi/10tian.html
 推荐查看天气：https://www.0dtq.com/shihezi/15tian.html
 推荐查看天气：https://www.0dtq.com/shihezi/40tian.html
 推荐查看天气：https://www.0dtq.com/alaer/
 推荐查看天气：https://www.0dtq.com/alaer/zuotian.html
 推荐查看天气：https://www.0dtq.com/alaer/7tian.html
 推荐查看天气：https://www.0dtq.com/alaer/10tian.html
 推荐查看天气：https://www.0dtq.com/alaer/15tian.html
 推荐查看天气：https://www.0dtq.com/alaer/40tian.html
 推荐查看天气：https://www.0dtq.com/tumushuke/
 推荐查看天气：https://www.0dtq.com/tumushuke/zuotian.html
 推荐查看天气：https://www.0dtq.com/tumushuke/7tian.html
 推荐查看天气：https://www.0dtq.com/tumushuke/10tian.html
 推荐查看天气：https://www.0dtq.com/tumushuke/15tian.html
 推荐查看天气：https://www.0dtq.com/tumushuke/40tian.html
 推荐查看天气：https://www.0dtq.com/wuzhishan/
 推荐查看天气：https://www.0dtq.com/wuzhishan/zuotian.html
 推荐查看天气：https://www.0dtq.com/wuzhishan/7tian.html
 推荐查看天气：https://www.0dtq.com/wuzhishan/10tian.html
 推荐查看天气：https://www.0dtq.com/wuzhishan/15tian.html
 推荐查看天气：https://www.0dtq.com/wuzhishan/40tian.html
 推荐查看天气：https://www.0dtq.com/qionghai/
 推荐查看天气：https://www.0dtq.com/qionghai/zuotian.html
 推荐查看天气：https://www.0dtq.com/qionghai/7tian.html
 推荐查看天气：https://www.0dtq.com/qionghai/10tian.html
 推荐查看天气：https://www.0dtq.com/qionghai/15tian.html
 推荐查看天气：https://www.0dtq.com/qionghai/40tian.html
 推荐查看天气：https://www.0dtq.com/danzhou/
 推荐查看天气：https://www.0dtq.com/danzhou/zuotian.html
 推荐查看天气：https://www.0dtq.com/danzhou/7tian.html

在 Node.js 服务里用 pg 库连接 PostgreSQL 时，很多人会直接在接口末尾调用 client.end()，或者把 pool 丢在全局不管。本地跑起来一切正常，部署到 Docker 或 PM2 后却经常遇到进程无法退出、连接数持续增长、数据库侧看到大量 idle 连接的问题。这通常是因为没有区分 client 和 pool 的生命周期：pool 内部维护着空闲连接，进程退出时不会自动释放；而在请求作用域中反复 new Pool() 更会让连接数失控。下面从实际代码出发，梳理在脚本、Express 服务和测试中如何正确关闭连接，以及如何用事件监听定位泄漏。

Node.js 中正确断开 PostgreSQL 连接池：避免进程挂起与连接泄漏

在 Node.js 服务里用 pg 库连接 PostgreSQL 时，很多人会直接在接口末尾调用 client.end()，或者把 pool 丢在全局不管。本地跑起来一切正常，部署到 Docker 或 PM2 后却经常遇到进程无法退出、连接数持续增长、数据库侧看到大量 idle 连接的问题。这通常是因为没有区分 client 和 pool 的生命周期：pool 内部维护着空闲连接，进程退出时不会自

人工智能

Node.js中pg库连接泄漏的常见原因及解决方案：区分Pool与client生命周期，脚本中await pool.end()，Express服务启动时创建Pool并在SIGTERM中关闭，测试中afterAll清理，设置connectionTimeoutMillis避免无限等待，通过pool.on('error')和pg_stat_activity定位泄漏。

集成测试

代码解释

PostgreSQL

Kubernetes

数据库

防火墙

容器

Docker

JSON

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

Node.js中pg库连接泄漏的常见原因及解决方案：区分Pool与client生命周期，脚本中await pool.end()，Express服务启动时创建Pool并在SIGTERM中关闭，测试中afterAll清理，设置connectionTimeoutMillis避免无限等待，通过pool.on('error')和...

Node.js 中正确断开 PostgreSQL 连接池：避免进程挂起与连接泄漏-腾讯云开发者社区-腾讯云

Node.js 中正确断开 PostgreSQL 连接池：避免进程挂起与连接泄漏

Node.js 中正确断开 PostgreSQL 连接池：避免进程挂起与连接泄漏

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐