SQLAlchemy+PostgreSQL插入时id字段非空约束报错排查

我之前看过类似问题《如何修复错误：(psycopg2.errors.NotNullViolation) null value in column "id" violates not-null constraint?》，但里面的方案解决不了我的问题。

我用SQLAlchemy连接PostgreSQL，定义的模型如下：

class Injury(db.Model):
    __tablename__ = "injury"

    id = Column(Integer, primary_key=True)
    name = Column(String)
    description = Column(String)

对应的数据库建表语句：

create table injury
(
    id               bigint not null
        constraint idx_182837_injury_pkey
            primary key
        constraint injury_id_key
            unique,
    name             text,
    description      text,
);

执行以下插入操作时：

injury = Injury(name='name', description='desc')
session.add(injury)
session.commit()

触发报错：

Error '(psycopg2.errors.NotNullViolation) null value in column "id" of relation "injury" violates not-null constraint

调试确认提交前injury对象的id属性为None。按预期，模型中设置primary_key=True应该让PostgreSQL自动生成id值，我尝试过使用SEQUENCE和IDENTITY，但仍出现相同错误。

核心问题 #

你的问题根源是模型定义与数据库表结构不匹配，且数据库表未配置主键自动生成规则：

1. 模型中id字段是Integer类型，但数据库表中是bigint，类型不兼容导致SQLAlchemy无法正确识别主键自动生成逻辑。
2. 数据库的id字段仅设置了非空和主键约束，但没有配置自动生成值的规则（比如IDENTITY或关联序列），PostgreSQL不会主动为该字段生成值。

解决方法 #

方法一：同步模型与表结构，配置IDENTITY自动生成

修改模型的id字段类型为BigInteger，并显式指定PostgreSQL的IDENTITY生成策略：

from sqlalchemy.dialects.postgresql import BIGINT, IDENTITY

class Injury(db.Model):
    __tablename__ = "injury"

    id = Column(BIGINT, primary_key=True, server_default=IDENTITY())
    name = Column(String)
    description = Column(String)

同时更新数据库表的建表语句，确保id字段带自动生成规则：

create table injury
(
    id               bigint generated always as identity not null
        constraint idx_182837_injury_pkey
            primary key,
    name             text,
    description      text
);

方法二：关联现有序列（如果数据库已用序列）

如果数据库表已经存在且依赖序列生成id，需要在模型中显式关联该序列：

from sqlalchemy import Sequence

class Injury(db.Model):
    __tablename__ = "injury"
    # 替换为你数据库中实际的序列名
    injury_id_seq = Sequence('injury_id_seq')
    id = Column(BIGINT, injury_id_seq, server_default=injury_id_seq.next_value(), primary_key=True)
    name = Column(String)
    description = Column(String)

验证要点 #

1. 确保模型字段类型与数据库表完全一致
2. 确认数据库的id字段配置了自动生成规则（IDENTITY或序列关联）
3. 提交后检查injury对象的id是否被正确赋值

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