Flask注册功能报FlushError NULL identity key的解决方法

sqlalchemy.orm.exc.FlushError: Instance <Users at 0x10bd8c580> has a NULL identity key 触发的核心原因是Users表的主键id没有配置自增属性，数据库插入新记录时不会自动生成主键值，SQLAlchemy提交事务时拿不到主键标识，直接抛出异常。
你的现有代码还有两个极易触发连锁错误的问题：

• 捕获IntegrityError后没有执行会话回滚，失败的事务会残留在数据库会话中，后续所有数据库操作都会被阻塞报错
• 高版本werkzeug已经移除了generate_password_hash方法中对method='sha256'的支持，手动指定该参数会直接抛参数错误

1. 修正数据模型定义 #

给id主键字段添加自增配置，同时给非空字段加上nullable=False约束避免脏数据，修改后的models.py代码如下：

from flask_login import UserMixin
from flask_sqlalchemy import SQLAlchemy

db = SQLAlchemy()

class Users(UserMixin, db.Model):
    id = db.Column(db.Integer, primary_key=True, autoincrement=True)
    username = db.Column(db.String(15), unique=True, nullable=False)
    email = db.Column(db.String(50), unique=True, nullable=False)
    password = db.Column(db.String, nullable=False)
    item = db.Column(db.String(25))
    amount = db.Column(db.Integer)

2. 修正注册接口的事务逻辑 #

调整密码哈希写法，异常分支添加会话回滚，修改register.py中对应代码段：

if password == confirm_password:
    # 高版本werkzeug不需要手动指定哈希方法，使用默认安全配置即可
    hashed_password = generate_password_hash(password)
    try:
        new_user = Users(
            username=username,
            email=email,
            password=hashed_password,
        )
        db.session.add(new_user)
        db.session.commit()
    except sqlalchemy.exc.IntegrityError:
        # 异常时必须回滚会话，清除失败事务
        db.session.rollback()
        return redirect(url_for('register.show') + '?error=user-or-email-exists')

    return redirect(url_for('login.show') + '?success=account-created')

3. 同步更新数据库表结构 #

修改模型后需要删除旧的数据库文件（使用SQLite时直接删除项目目录下的.db后缀文件），在Flask应用上下文中执行一次表创建命令完成结构更新：

# 该代码临时放在应用启动文件中执行一次即可，执行完成后删除
with app.app_context():
    db.create_all()

如果你使用的是MySQL/PostgreSQL数据库，添加autoincrement=True配置后，SQLAlchemy会自动帮你维护主键自增序列/属性，不需要手动操作数据库配置。

完成以上修改后重启应用，注册新用户时数据库会自动生成自增主键ID，不会再出现NULL identity key相关报错。

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