Node.js应用中PostgreSQL序列事务回滚后仍递增的问题

在Node.js应用中使用pg库和连接池操作PostgreSQL时，遇到一个问题：即便验证或插入出错后显式回滚了事务，PostgreSQL的序列（nextval）仍会持续递增。相关简化代码如下：

// userController.js
const pool = require('../db/pool');
const userSchema = require('../schemas/userSchema');

const addUser = async (full_name, phone_number, password) => {
  const client = await pool.connect();

  try {
    // 启动事务
    await client.query('BEGIN');

    // 使用Zod验证输入数据
    const userData = userSchema.parse({ full_name, phone_number, password });

    // 插入数据至users表
    const query = `
      INSERT INTO users (full_name, phone_number, password)
      VALUES ($1, $2, $3)
      RETURNING *;
    `;

    const values = [userData.full_name, userData.phone_number, userData.password];

    const result = await client.query(query, values);

    // 提交事务
    await client.query('COMMIT');

    // 返回新创建的用户
    return result.rows[0];
  } catch (error) {
    // 出错时回滚事务
    await client.query('ROLLBACK');
    console.error('Error adding user:', error);
    throw error; // 重新抛出错误供调用代码捕获
  } finally {
    client.release(); // 将客户端放回连接池
  }
};

module.exports = {
  addUser,
};

即便catch块执行了回滚，插入出错时序列仍递增。推测这是PostgreSQL特定行为，希望得到原因分析及替代方案建议。

补充信息 #

• Node.js版本：18.19.1
• PostgreSQL版本：16.2
• pg库版本：8.11.3
• 操作系统：macOS Monterey

原因分析 #

这是PostgreSQL的设计特性，并非bug：

• 序列是独立于事务的对象，调用nextval()（包括INSERT时自动调用序列生成主键）会直接消耗序列值，这个操作不会被事务回滚影响。
• 这种设计是为了避免多并发事务间的竞争，保证序列生成的性能和唯一性。如果回滚要回退序列值，会引发锁冲突和性能下降。

解决方案建议 #

根据业务需求选择合适方案：

1. 接受序列间隙（推荐） #

如果业务仅需要主键唯一，不要求严格连续，这是最省心的方案。序列间隙不影响数据正确性，也是PostgreSQL官方默认推荐的方式，能最大化并发性能。

2. 提前验证输入，减少无效序列消耗 #

在启动事务前先完成输入验证，避免因验证失败导致的事务回滚，从而减少序列的无意义消耗。修改代码如下：

const addUser = async (full_name, phone_number, password) => {
  // 先做输入验证，避免启动事务后再失败
  const userData = userSchema.parse({ full_name, phone_number, password });
  
  const client = await pool.connect();

  try {
    await client.query('BEGIN');

    const query = `
      INSERT INTO users (full_name, phone_number, password)
      VALUES ($1, $2, $3)
      RETURNING *;
    `;

    const values = [userData.full_name, userData.phone_number, userData.password];
    const result = await client.query(query, values);

    await client.query('COMMIT');
    return result.rows[0];
  } catch (error) {
    await client.query('ROLLBACK');
    console.error('Error adding user:', error);
    throw error;
  } finally {
    client.release();
  }
};

3. 使用IDENTITY列替代序列（语法优化） #

PostgreSQL 10+支持GENERATED AS IDENTITY语法，本质仍基于序列实现，同样会产生间隙，但语法更标准，和其他数据库兼容性更好：

ALTER TABLE users ALTER COLUMN id SET GENERATED ALWAYS AS IDENTITY;

4. 手动控制序列值（不推荐高并发场景） #

如果必须保证主键连续，可以手动管理序列值：先查询当前序列值，插入时手动指定主键，事务提交后再调用nextval()更新序列。但这种方式需要额外加锁，极易引发性能瓶颈和死锁，仅适合低并发场景。

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