SQLAlchemy自增ID跳过问题：如何避免插入失败后ID不连续？

这种跳号现象是数据库自增序列（如MySQL的AUTO_INCREMENT、PostgreSQL的SERIAL）的固有机制：当发起插入请求时，数据库会先预分配一个ID，即便后续事务因重复记录等原因回滚，这个已分配的ID也不会被回收——序列的生成独立于事务，目的是避免并发场景下的ID冲突问题。

以下是几种解决思路：

• 插入前提前做唯一性校验
  在执行add()操作前，先查询数据库确认是否存在重复记录，仅当无重复时再执行插入，从根源上避免插入失败，自然不会触发ID跳号。
  示例代码：

  def create_record(db: Session, data):
      # 检查目标字段是否已存在重复值
      existing_item = db.query(YourModel).filter(YourModel.unique_field == data["unique_field"]).first()
      if existing_item:
          raise ValueError("该记录已存在")
      
      new_item = YourModel(**data)
      db.add(new_item)
      db.commit()
      db.refresh(new_item)
      return new_item
  

• 捕获异常后重试插入（仅适配并发场景）
  如果无法完全避免并发下的唯一性冲突，可以捕获IntegrityError后重试插入，但这种方式仍可能出现跳号，仅能保证最终插入成功。注意控制重试次数，避免死循环。
  示例代码：

  from sqlalchemy.exc import IntegrityError
  
  def create_record_with_retry(db: Session, data, max_retries=3):
      for _ in range(max_retries):
          try:
              new_item = YourModel(**data)
              db.add(new_item)
              db.commit()
              db.refresh(new_item)
              return new_item
          except IntegrityError:
              db.rollback()
      raise ValueError("重试多次仍无法插入，记录可能已存在")
  

• 改用应用层生成唯一ID
  放弃数据库自增，使用UUID、雪花算法等生成全局唯一ID，彻底绕过数据库的自增序列机制，从根本上解决跳号问题。这种方式适合对ID连续性有严格要求的场景。
  示例代码：

  import uuid
  from sqlalchemy import Column, String
  
  class YourModel(Base):
      __tablename__ = "your_table"
      id = Column(String(36), primary_key=True, default=lambda: str(uuid.uuid4()))
      # 其他字段定义...
  

需要注意：数据库自增序列的跳号是设计层面的正常行为，核心是为了保证并发性能与数据一致性。如果不是对ID连续性有强需求，无需刻意处理——自增ID的本质是唯一标识记录，而非严格连续的序号。

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