Flask-SQLAlchemy在PythonAnywhere上数据库连接断开，配置是否需修改？

针对你遇到的mysql.connector.errors.OperationalError: MySQL Connection not available错误，结合当前使用的Flask-SQLAlchemy 3.0.5和SQLAlchemy 2.0.19版本，必须将原有的SQLALCHEMY_POOL_RECYCLE配置替换为SQLALCHEMY_ENGINE_OPTIONS的写法，原因如下：

1. 版本兼容性要求 #

Flask-SQLAlchemy 3.x及以上版本完全适配SQLAlchemy 2.x架构，已废弃SQLALCHEMY_POOL_RECYCLE这类直接暴露的连接池配置项，转而要求所有SQLAlchemy引擎级参数统一通过SQLALCHEMY_ENGINE_OPTIONS字典传递。原配置方式不仅不会生效，还可能触发配置弃用警告。

2. PythonAnywhere连接超时的适配 #

PythonAnywhere的MySQL服务器默认会断开闲置300秒以上的连接，推荐的280秒连接回收时间必须正确配置到引擎参数中，才能让SQLAlchemy连接池主动在连接被服务器断开前回收并重建，从根源避免“连接不可用”的错误。

正确配置示例 #

# 移除原有的 SQLALCHEMY_POOL_RECYCLE 配置
# app.config["SQLALCHEMY_POOL_RECYCLE"] = 280

# 使用新的配置方式
app.config['SQLALCHEMY_ENGINE_OPTIONS'] = {
    'pool_recycle': 280,
    # 可选：添加 pool_pre_ping 进一步确保连接有效性
    'pool_pre_ping': True
}

• pool_pre_ping=True会让SQLAlchemy在每次从连接池获取连接前，自动向数据库发送ping请求验证连接可用性，即便出现意外断开的连接也会被自动重建，进一步降低错误概率。

最后注意事项 #

• 删除旧的SQLALCHEMY_POOL_RECYCLE配置，避免潜在的配置冲突。
• 修改配置后，务必重启PythonAnywhere上的Web应用，让新配置生效。

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