已设置SQLALCHEMY_POOL_RECYCLE，Flask-SQLAlchemy仍无法回收MySQL连接

问题原因分析 #

你设置了SQLALCHEMY_POOL_RECYCLE=3但仍出现超时错误，核心原因是：

• SQLAlchemy的连接池回收机制仅在连接被放回池或从池中取出时触发检查。你的测试代码中，q1查询后未关闭session，连接一直被当前session持有，没有放回池；time.sleep(10)后，q2复用同一个已被MySQL断开的连接，此时pool_recycle的检查逻辑根本没机会运行。
• 你的wait_timeout=8，而pool_recycle设为3，但由于连接未被回收，这个配置没有生效。

解决方案 #

1. 启用连接有效性预检查（pool_pre_ping） #

这是最可靠的方案，SQLAlchemy会在每次从连接池取连接时，自动发送一个轻量测试查询（如SELECT 1）验证连接是否有效，若无效则自动重建连接。

在Flask配置中添加：

app.config["SQLALCHEMY_ENGINE_OPTIONS"] = {
    "pool_pre_ping": True,
    "pool_recycle": 6  # 设置为比MySQL wait_timeout小1-2秒，避免网络延迟导致的时间差
}

同时保持SQLALCHEMY_POOL_RECYCLE=6（和engine里的配置一致，确保Flask-SQLAlchemy传递正确参数）。

2. 手动回收连接（适用于测试/非请求场景） #

在非Web请求的测试代码中，每次使用完session后手动关闭，让连接放回池，触发pool_recycle检查：

def test():
    app = create_app()
    with app.app_context():
        q1 = TestData.query.get(0)
        print(q1)
        db.session.remove()  # 手动关闭session，将连接放回池
        time.sleep(10)
        q2 = TestData.query.get(1)
        print(q2)

3. 调整pool_recycle与wait_timeout的关系 #

确保pool_recycle的值小于MySQL的wait_timeout（建议小1-2秒），比如你设置wait_timeout=8，则pool_recycle设为6，避免因网络延迟导致连接在SQLAlchemy回收前被MySQL断开。

修改后的完整测试代码 #

import time

import sqlalchemy as sql
from flask import Flask
from flask_sqlalchemy import SQLAlchemy

db = SQLAlchemy()


class TestData(db.Model):
    id = sql.Column(sql.BigInteger, primary_key=True)

def create_app() -> Flask:
    app: Flask = Flask(__name__)
    app.config["SQLALCHEMY_DATABASE_URI"] = "mysql+pymysql://mysql_host"
    app.config["SQLALCHEMY_POOL_SIZE"] = 1
    app.config["SQLALCHEMY_POOL_RECYCLE"] = 6
    app.config["SQLALCHEMY_ENGINE_OPTIONS"] = {
        "pool_pre_ping": True,
        "pool_recycle": 6
    }
    db.init_app(app)
    return app


def test():
    app = create_app()
    with app.app_context():
        q1 = TestData.query.get(0)
        print(q1)
        db.session.remove()
        time.sleep(10)
        q2 = TestData.query.get(1)
        print(q2)

test()

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