Postgres int类型自增ID问题：FastAPI传入ID被自动丢弃

原因 #

你定义的id字段是Integer类型且设为primary_key=True，在SQLAlchemy中，这种配置默认会开启autoincrement=True（针对PostgreSQL、MySQL等主流数据库），数据库会自动为该字段创建自增序列（比如PostgreSQL的serial、MySQL的auto_increment）。此时即便你手动传入id值，SQLAlchemy在生成INSERT语句时会跳过该字段，数据库会直接使用自增序列生成的值，导致传入的id被丢弃。

解决方法 #

要允许手动指定id值，需要修改字段定义，关闭自动自增：

1. 更新模型定义
   修改models.py中的id字段，添加autoincrement=False参数：

   class Post(Base):
       __tablename__ = "posts"
   
       id = Column(Integer, primary_key=True, nullable=False, autoincrement=False)
       title = Column(String, nullable=False)
       content = Column(String, nullable=False)
       published = Column(Boolean, server_default='TRUE')
       created_at = Column(TIMESTAMP(timezone=True), nullable=False, server_default=text('now()'))
   

2. 同步数据库结构
   如果使用Alembic做数据库迁移，执行以下命令更新表结构：

   alembic revision --autogenerate -m "disable post id autoincrement"
   alembic upgrade head
   

   若未使用迁移工具，需要手动修改数据库表，移除id字段的自增约束（比如PostgreSQL中删除对应的序列，MySQL中去掉AUTO_INCREMENT属性）。

修改完成后，通过Postman传入id值时，数据库会使用你指定的数值，不再自动生成。注意要保证传入的id不与现有数据重复，否则会触发主键冲突错误。

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