Node.js / 系统课时
处理事务与连接释放
处理事务与连接释放
一次请求若要连续修改账户、订单、库存等多张表,任一步失败都不能留下“写了一半”的数据。本节使用 PostgreSQL 与 pg 连接池完成一笔积分转账:所有 SQL 绑定同一连接,成功提交,异常回滚,并在任何路径下释放连接。
学习目标
- 使用
pool.connect()获取同一客户端执行BEGIN、多条 SQL 与COMMIT。 - 在异常路径执行
ROLLBACK,并用finally保证client.release()一定发生。 - 通过余额与日志记录验证事务的原子性,识别连接泄漏和错误的
pool.query()用法。
事务必须绑定一条连接
PostgreSQL 的事务状态属于数据库连接,因此 BEGIN 之后的语句必须继续由同一个 client 执行。pool.query() 适合独立查询,但它会自行借出可用连接,事务中混用它可能让后续 SQL 落到另一条连接上。
推荐固定成这条执行链:pool.connect() 借出连接,BEGIN 开始事务,多步写入全部使用 client.query(),成功后 COMMIT;任一步抛错则 ROLLBACK;最后无论成功失败都进入 finally 释放连接。

编写可运行的提交与回滚
下面示例假定项目已安装 pg,并通过 DATABASE_URL 指向可写的 PostgreSQL 数据库。连接池显式限制为最多 10 条连接,连接等待超过 2000 ms 就失败,便于开发阶段尽早暴露连接未释放问题。
import pg from 'pg';
const { Pool } = pg;
const pool = new Pool({
connectionString: process.env.DATABASE_URL,
max: 10,
connectionTimeoutMillis: 2000,
idleTimeoutMillis: 10000
});
async function setup() {
await pool.query(`
CREATE TABLE IF NOT EXISTS accounts (
id integer PRIMARY KEY,
balance integer NOT NULL CHECK (balance >= 0)
)
`);
await pool.query(`
CREATE TABLE IF NOT EXISTS transfer_log (
id bigserial PRIMARY KEY,
from_id integer NOT NULL,
to_id integer NOT NULL,
amount integer NOT NULL CHECK (amount > 0),
created_at timestamptz NOT NULL DEFAULT now()
)
`);
await pool.query(`
INSERT INTO accounts (id, balance)
VALUES (1, 100), (2, 40)
ON CONFLICT (id) DO UPDATE SET balance = EXCLUDED.balance
`);
}
async function transferCredits(fromId, toId, amount) {
const client = await pool.connect();
try {
await client.query('BEGIN');
const debit = await client.query(
`UPDATE accounts
SET balance = balance - $1
WHERE id = $2 AND balance >= $1
RETURNING balance`,
[amount, fromId]
);
if (debit.rowCount !== 1) {
throw new Error('INSUFFICIENT_FUNDS');
}
const credit = await client.query(
`UPDATE accounts
SET balance = balance + $1
WHERE id = $2
RETURNING balance`,
[amount, toId]
);
if (credit.rowCount !== 1) {
throw new Error('TARGET_NOT_FOUND');
}
await client.query(
`INSERT INTO transfer_log (from_id, to_id, amount)
VALUES ($1, $2, $3)`,
[fromId, toId, amount]
);
await client.query('COMMIT');
return {
fromBalance: debit.rows[0].balance,
toBalance: credit.rows[0].balance
};
} catch (error) {
await client.query('ROLLBACK');
throw error;
} finally {
client.release();
}
}
async function main() {
await setup();
try {
const result = await transferCredits(1, 2, 25);
console.log(
`transfer ok: from=${result.fromBalance}, to=${result.toBalance}`
);
} finally {
await pool.end();
}
}
main().catch((error) => {
console.error(error.message);
process.exitCode = 1;
});预期输出:
transfer ok: from=75, to=65将调用金额从 25 改为 125 时,扣减 SQL 的 rowCount 为 0,代码抛出 INSUFFICIENT_FUNDS 并执行 ROLLBACK。由于扣减、增加和日志写入属于同一事务,失败后不会留下半完成的转账记录。
释放连接与失败边界
client.release() 必须放在 finally,不能只写在 COMMIT 后面。否则只要中间 SQL 抛错,连接就会一直保持“已借出”状态;当 10 条连接都泄漏后,新的 pool.connect() 会排队,并在本例的 2000 ms 等待上限后失败。
还要区分“业务 SQL 失败”和“连接已经不可用”。前者通常执行 ROLLBACK 后正常 release() 即可;如果连接因网络中断等原因已无法继续通信,可使用 client.release(true) 销毁该连接,让连接池后续建立新连接,而不是把坏连接放回空闲池。
验收事务是否真的生效
成功路径至少检查三件事:账户 1 从 100 变为 75,账户 2 从 40 变为 65,transfer_log 新增一条 amount=25 的记录。随后把金额改为 125 再运行,失败后两边余额应仍保持初始化后的 100 和 40,日志也不应新增该失败转账。
若压测时出现请求越来越慢,同时 pool.waitingCount 持续上升,优先检查是否存在没有进入 finally 的连接借用路径。事务代码通过“同一连接、异常回滚、最终释放”这三个条件后,才算真正完成了数据库层面的原子写入。