使用Flask/SQLAlchemy向Postgres保存数据时出错

这个错误的核心原因是PostgreSQL数据库中users表的id字段未正确配置自增序列，导致插入新记录时无法自动生成主键值，违反了非空约束。以下是具体排查和修复步骤：

1. 检查数据库表的自增配置 #

先执行SQL查询确认id字段的默认值设置：

SELECT column_default FROM information_schema.columns WHERE table_name='users' AND column_name='id';

如果返回结果不是nextval('users_id_seq'::regclass)这类指向序列的内容，说明自增序列未正确关联到id字段。

2. 手动修复自增序列 #

如果序列缺失或未关联，执行以下SQL语句修复：

-- 创建对应序列（如果不存在）
CREATE SEQUENCE IF NOT EXISTS users_id_seq;
-- 将序列关联到id字段，设置默认值为序列的下一个值
ALTER TABLE users ALTER COLUMN id SET DEFAULT nextval('users_id_seq');
-- 同步序列当前值与表中现有最大id（若表已有数据）
SELECT setval('users_id_seq', COALESCE((SELECT MAX(id) FROM users), 1));

3. 优化模型定义（可选） #

对于PostgreSQL，Integer类型的主键在设置primary_key=True时，SQLAlchemy默认会自动使用serial类型（自带自增序列），显式添加autoincrement=True在部分场景下可能引发不必要的冲突。可以尝试修改模型：

class User(db.Model):
    __tablename__ = 'users'
    id = db.Column(db.Integer, primary_key=True)  # 移除autoincrement=True
    phone_number = db.Column(db.String, nullable=False)

    # One-to-many relationship between users and dreams
    dreams = db.relationship('Dream', backref='user', lazy=True)

    def __init__(self, phone_number):
       self.phone_number = phone_number

之后建议使用Flask-Migrate工具管理表结构迁移，避免手动操作导致的结构不一致。

4. 升级依赖版本 #

确保使用的Flask-SQLAlchemy和SQLAlchemy是稳定版本，旧版本可能存在PostgreSQL自增字段的兼容问题：

pip install --upgrade flask-sqlalchemy sqlalchemy

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