如何修复Flask-SQLAlchemy更新用户名时的外键约束违反错误

报错核心来自两点：

• SQLAlchemy默认提交顺序为先更新主表users、后更新从表logo。你虽然在代码里同时给两个表的username字段赋了新值，但实际执行SQL时，主表username先被改成新值的瞬间，从表外键还保留旧值，直接触发外键约束校验失败。
• 外键设计存在缺陷：用username这种会被修改的业务字段做外键关联，本身就会带来额外的约束维护成本，正规设计应当用不会变更的主键ID做外键。

调整执行顺序，分三次刷入会话，避开约束校验冲突：

user01 = User.query.filter_by(username="user01").first()
logo = Logo.query.filter_by(username="user01").first()
new_username= "newusertest"

# 先临时解除外键关联
logo.username = None
db.session.flush()

# 更新主表用户名
user01.username = new_username
db.session.flush()

# 重新绑定新的外键值
logo.username = new_username
db.session.commit()

注意：该方案需要将Logo.username字段设置为nullable=True，否则临时置空的操作会触发非空约束报错。

将外键关联字段从易变的username改为用户表固定不变的主键id，后续修改用户名完全不需要操作logo表，不会再触发同类错误：

1. 修改模型定义：

class Logo(db.Model):
    __tablename__ = "logo"
    id = db.Column(db.Integer, primary_key=True)
    filename = db.Column(db.String(100))
    data = db.Column(db.LargeBinary)
    # 外键关联users表主键id，加unique保证一对一关系
    user_id = db.Column(db.Integer, db.ForeignKey("users.id"), unique=True)
    user = db.relationship("User", backref=backref("logo", uselist=False))

    def __init__(self, filename: str, data, user_id: int):
        self.filename = filename
        self.data = data
        self.user_id = user_id

    def __repr__(self) -> str:
        return "<Logo (filename='{}', user_id='{}')>".format(
            self.filename, self.user_id
        )


class User(UserMixin, db.Model):
    __tablename__ = "users"

    id = db.Column(db.Integer, primary_key=True)
    username = db.Column(db.String(100), unique=True)
    password = db.Column(
        db.String(200), primary_key=False, unique=False, nullable=False
    )
    is_admin = db.Column(db.Boolean, default=False, nullable=True)

    def __init__(
        self,
        username: str,
        password: str,
        is_admin: bool = False,
    ):
        self.username = username
        self.password = self.set_password(password)
        self.is_admin = is_admin

    def get_id(self):
        return self.username

    def set_password(self, password: str) -> str:
        return generate_password_hash(password, method="sha256")

    def check_password(self, password: str):
        return check_password_hash(self.password, password)

    def __repr__(self) -> str:
        return "<User {}>".format(self.username)

2. 执行数据库迁移同步表结构后，修改用户名的逻辑可以简化为：

user01 = User.query.filter_by(username="user01").first()
user01.username = "newusertest"
db.session.commit()

因为外键关联的是永不变化的用户ID，无论username怎么修改，都不会破坏外键约束，也不需要额外操作logo表。

内容的提问来源于stack exchange，提问作者JA-pythonista