部署到Azure的Python Flask应用报sqlalchemy.exc.InvalidRequestError如何解决

• Azure云数据库默认配置了300秒的空闲连接自动断开策略，本地调试时连接不会长期闲置因此不会触发该问题，部署到App Service后低峰期连接闲置被服务器主动断开，SQLAlchemy连接池内留存了失效连接
• 你手动实现的事务处理逻辑仅覆盖了自定义业务代码，Flask-Security-Too、Flask-Login等框架内部发起的数据库查询遇到断连异常时没有对应的回滚逻辑，导致数据库会话进入无效状态，后续所有复用该会话的请求都会抛出事务未回滚的错误
• 默认配置下SQLAlchemy不会校验连接池内连接的可用性，直接取出失效连接使用会直接触发异常

1. 调整SQLAlchemy连接池核心配置（优先执行，可解决90%同类断连问题） #

在Flask配置中新增以下参数，适配Azure数据库的连接管理规则：

# 连接回收时间必须小于Azure数据库的空闲超时时间（默认300秒，此处设290秒留冗余）
SQLALCHEMY_POOL_RECYCLE = 290
# 开启连接预校验，每次从连接池取连接时先检测是否存活，失效则自动重建连接
SQLALCHEMY_POOL_PRE_PING = True
# 按需调整连接池大小，小流量场景保持默认5即可
SQLALCHEMY_POOL_SIZE = 5
SQLALCHEMY_MAX_OVERFLOW = 10
# 数据库连接URI新增超时参数，避免hang住请求，示例为MySQL，其他数据库替换为对应驱动的参数即可
SQLALCHEMY_DATABASE_URI = "mysql+pymysql://<用户名>:<密码>@<数据库地址>/<库名>?connect_timeout=10&read_timeout=30"

2. 新增全局事务兜底逻辑 #

通过Flask的应用上下文销毁钩子，统一处理所有请求结束后的会话清理，覆盖框架内部未捕获的异常场景：

@app.teardown_appcontext
def cleanup_session(exception=None):
    # 只要请求过程中出现异常，强制回滚事务
    if exception is not None:
        db.session.rollback()
    # 移除当前线程绑定的会话，避免后续请求复用无效会话
    db.session.remove()

3. 优化现有代码的会话操作 #

将你现有代码中所有db.session.close()调用替换为db.session.remove()，适配Flask-SQLAlchemy的线程隔离会话管理机制；同时统一事务操作入口，将usr_datastore.commit()替换为db.session.commit()，避免多实例操作事务不同步的问题。

4. 补充异常日志定位根因 #

如果调整后问题仍存在，新增全局异常钩子打印完整栈信息，确认是否有未覆盖的异常分支：

@app.errorhandler(Exception)
def log_exception(e):
    current_app.logger.error(f"未捕获异常: {str(e)}", exc_info=True)
    db.session.rollback()
    return "服务异常", 500

部署后停止所有请求5分钟，再主动发起登录请求验证是否可以正常执行，无报错则说明修复生效。

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