PostgreSQL序列未按1递增问题及SQLAlchemy正确用法咨询

问题根源 #

你遇到的跳号或看似回滚的问题，主要来自三个原因：

1. 事务回滚导致的序列值消耗：手动调用nextval后，不管后续事务是否提交，PostgreSQL都会消耗这个序列值。如果Lambda执行中出错、session未提交就结束，已取的ID会被浪费，后续插入就会出现跳号。
2. 序列缓存机制：PostgreSQL序列默认会缓存10个值，当数据库重启、连接池回收连接时，缓存中未使用的序列值会丢失，直接导致跳号。
3. 手动ID生成与ORM的不一致：脱离ORM自动管理，手动生成ID再插入，容易出现事务层面的不一致，加剧跳号问题。

正确的SQLAlchemy使用方式 #

方法1：模型直接关联序列（推荐） #

在定义Student模型时，将id字段直接关联到目标序列，让SQLAlchemy自动处理ID生成，无需手动调用nextval：

from sqlalchemy import Column, Integer, String, Sequence
from sqlalchemy.ext.declarative import declarative_base

Base = declarative_base()

class Student(Base):
    __tablename__ = 'student'
    # 关联指定序列，若序列已创建，start参数可省略
    id = Column(Integer, Sequence('mydb.student_id_seq', start=20000101), primary_key=True)
    name = Column(String)
    class_id = Column(String)
    grade = Column(String)

# 插入时无需指定id
student = Student(
    name="Name",
    class_id="Class ID",
    grade="A"
)
session.add(student)
session.commit()

这种方式下，SQLAlchemy会在事务提交时才调用nextval，如果事务回滚，序列值不会被消耗，从根源避免了回滚导致的跳号。

方法2：依赖数据库默认值 #

如果你的表已经将序列设为id字段的默认值（建表语句类似id INTEGER DEFAULT nextval('mydb.student_id_seq') PRIMARY KEY），可以让数据库自动处理ID生成：

from sqlalchemy import Column, Integer, String, text
from sqlalchemy.ext.declarative import declarative_base

Base = declarative_base()

class Student(Base):
    __tablename__ = 'student'
    id = Column(Integer, primary_key=True, server_default=text("nextval('mydb.student_id_seq')"))
    name = Column(String)
    class_id = Column(String)
    grade = Column(String)

# 插入逻辑同上，无需指定id
student = Student(
    name="Name",
    class_id="Class ID",
    grade="A"
)
session.add(student)
session.commit()

这种方式完全依赖数据库的默认值逻辑，ORM仅负责提交插入请求，ID生成的一致性由PostgreSQL保证。

解决序列缓存导致的跳号 #

如果是缓存丢失引发的跳号，可以修改序列关闭缓存（或设置更小的缓存值）：

-- 关闭序列缓存，每次仅生成1个值
ALTER SEQUENCE mydb.student_id_seq CACHE 1;

注意：关闭缓存会略微降低高并发场景下的序列生成性能，但能彻底避免缓存丢失导致的跳号。如果业务对ID连续性要求极高，建议使用此设置。

为什么手动调用nextval不可取 #

你之前的写法存在两个核心问题：

• nextval调用和插入操作虽然在同一个session，但nextval执行后序列值立即被消耗，哪怕后续事务回滚，这个值也无法回收。
• Lambda的无状态特性会加剧问题：每次执行可能创建新session，一旦执行中断，已取的ID直接浪费，导致跳号频繁。

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