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 就失败,便于开发阶段尽早暴露连接未释放问题。

js
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;
});

预期输出:

text
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 的连接借用路径。事务代码通过“同一连接、异常回滚、最终释放”这三个条件后,才算真正完成了数据库层面的原子写入。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

处理事务与连接释放

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通