为什么SQLAlchemy向PostgreSQL插入用户数据时主键id传null值？

你在pgAdmin4手动创建users表时，漏给整型主键id列绑定PostgreSQL要求的自增序列默认值。

• 之前代码在SQLite、MySQL下能正常运行，是因为这两类数据库会对定义为主键的整型列隐式开启自增属性，不需要你手动配置；但PostgreSQL没有这类隐式兼容逻辑，不会自动为整型主键配置自增规则。
• 你的SQLAlchemy模型里把id设为primary_key=True时，框架会默认把该列识别为自增列，执行插入时不会主动传入id值，等着数据库自动生成并回传新的主键值；但你手动建的表的id列没有配置对应的自增默认值，接收到不带id的插入请求后，就会把id字段赋值为null，直接触发主键非空的约束报错。

• 最省事的方案：删掉pgAdmin4里手动创建的users表，在应用启动流程中执行db.create_all()，让SQLAlchemy根据模型定义自动完成建表操作。SQLAlchemy会自动为PostgreSQL的整型主键匹配对应的自增序列，完全对齐你的模型逻辑，不会再出现插入时id为null的问题。
• 如果表里已经有存量数据不能删除，只需要手动补全自增序列的绑定规则即可，在pgAdmin4的查询编辑器里依次执行以下SQL语句：
  1. 为id列创建专属自增序列：CREATE SEQUENCE IF NOT EXISTS users_id_seq OWNED BY users.id;
  2. 给id列设置默认取值规则，保证插入时没有传入id的场景下，自动从序列取新值：ALTER TABLE users ALTER COLUMN id SET DEFAULT nextval('users_id_seq');
  3. 校准序列的当前值匹配表内现有最大id，避免后续插入时出现主键值冲突：SELECT setval('users_id_seq', (SELECT MAX(id) FROM users));

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