Flask+SQLAlchemy闲置后请求报OperationalError，刷新恢复的解决问询

问题根源 #

这个错误是因为数据库端会主动断开长时间闲置的连接，但SQLAlchemy连接池里的旧连接还没被清理，首次请求时用了失效的连接就触发报错，刷新后会重新创建新连接，所以恢复正常。

解决方案 #

1. 配置SQLAlchemy连接池参数（从根源避免） #

直接在配置里开启连接预检查，同时设置连接回收时间，让SQLAlchemy主动维护有效连接：
修改你的init.py配置部分：

sslify = SSLify(app)
app.config.from_pyfile('config.py')
app.config['SQLALCHEMY_DATABASE_URI'] = "mssql+pyodbc:///?odbc_connect=%s" % params

# 新增连接池配置
app.config['SQLALCHEMY_POOL_PRE_PING'] = True  # 请求前检查连接有效性，无效则重建
app.config['SQLALCHEMY_POOL_RECYCLE'] = 300    # 5分钟后主动回收连接，要短于数据库的闲置超时时间
app.config['SQLALCHEMY_POOL_SIZE'] = 10        # 根据业务调整连接池大小

db.init_app(app)

pool_pre_ping是最关键的参数，它会在每次使用连接前发送测试语句验证连接，无效就自动重建，基本能解决大部分闲置连接问题。

2. 全局异常捕获（兜底处理） #

如果上面的配置还遇到偶发情况，就加全局异常处理，捕获OperationalError后重试或重定向，同时限制重试次数避免死循环：

from sqlalchemy.exc import OperationalError
from flask import redirect, request, session

@app.errorhandler(OperationalError)
def handle_db_connection_error(e):
    # 匹配连接重置类错误码
    if '08S01' in str(e) or '10054' in str(e):
        # 用session记录重试次数，防止死循环
        retry_count = session.get('db_retry_count', 0)
        if retry_count < 2:  # 最多重试2次
            session['db_retry_count'] = retry_count + 1
            # 强制断开当前失效连接，让连接池重新生成新连接
            db.session.remove()
            # 重定向到当前页面，实现自动刷新
            return redirect(request.full_path)
        else:
            # 超过重试次数，返回真实错误
            session.pop('db_retry_count', None)
            return "数据库连接失败，请稍后重试", 500
    # 其他数据库操作错误，直接返回500
    return "数据库操作错误", 500

注意事项 #

• pool_recycle的值必须小于数据库的闲置连接超时时间（比如SQL Server默认闲置超时为30分钟，设5分钟更安全），否则数据库已经断开连接，SQLAlchemy还未回收旧连接，仍会报错。
• Flask-SQLAlchemy 3.x以上版本中SQLALCHEMY_POOL_PRE_PING默认已开启，但显式配置能确保生效。

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