Flask操作PostgreSQL时SQLAlchemy报session绑定错误该如何解决

该报错是SQLAlchemy的会话（Session）隔离机制触发的冲突：

• 你代码中查询得到的Users实体对象，已经被绑定到ID为5的旧会话实例上，你当前操作使用的是ID为6的新会话，SQLAlchemy不允许跨会话操作同一个绑定过的实体对象，因此抛出异常。
• 常见触发场景有三类：
  • 项目中重复初始化了db实例，查询用的是旧db实例创建的会话，更新/删除用的是新db实例的会话
  • 之前的请求没有正常关闭会话，实体对象仍被残留的旧会话持有，新请求创建新会话后操作同一个对象触发冲突
  • 跨线程/跨请求复用了同一个查询得到的实体对象，不同请求对应不同会话导致不匹配

临时快速修复（适配当前代码） #

操作实体前先将对象合并到当前会话，替换原有的add操作即可：

修复后的更新接口 #

@app.route('/users/<id_user>', methods = ['PUT'])
def updateUser(id_user):
    user = Users.query.get_or_404(id_user)
    # 合并对象到当前会话
    user = db.session.merge(user)
    data = request.get_json()
    user.name = data['name']
    user.phone = data['phone']
    user.role = data['role']
    db.session.commit()
    return {"message": f"user updated."}

修复后的删除接口 #

@app.route('/users/<id_user>', methods = ['DELETE'])
def deleteUser(id_user):
    user = Users.query.get_or_404(id_user)
    # 合并对象到当前会话
    user = db.session.merge(user)
    db.session.delete(user)
    db.session.commit()
    return {"message": f"user deleted."}

根因修复（避免后续复发） #

• 全局仅初始化一次db = SQLAlchemy(app)，不要在多个模块重复创建db实例
• 不要在请求上下文之外手动创建Session查询数据，再放到请求内做修改/删除操作
• 配置请求结束自动释放会话，添加全局钩子：

@app.teardown_appcontext
def shutdown_session(exception=None):
    db.session.remove()

• 单条数据操作可以直接用DML语句跳过实体绑定环节，比如删除操作可以直接写Users.query.filter_by(id=id_user).delete()，不需要先查询实体对象，从根源避免会话绑定冲突。

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