PythonAnywhere部署Flask报MySQL连接不可用500错误排查

这个报错和worker数量不足、操作后没手动关连接没有关系，核心是两个配置问题：

1. 应用工厂模式写法错误：你在create_app外部提前创建了Flask app实例，并且直接把SQLAlchemy对象绑定到了这个全局app上，多worker进程下会出现连接池状态错乱，不同worker拿到已经失效/被占用的数据库连接。
2. SQLAlchemy连接池没有适配PythonAnywhere的MySQL规则：PythonAnywhere的MySQL服务会主动关闭空闲超过5分钟的连接，而SQLAlchemy默认不会检查连接池内的连接是否已经被服务端断开，拿到失效连接执行操作就会抛出MySQL Connection not available错误。你看到的SIGPIPE日志是数据库报错导致请求异常中断、客户端提前断开连接后产生的连锁输出，不是触发500的原因。

问题1：是否每次执行数据库操作后都需要调用db.session.close()关闭连接？ #

不需要。
Flask-SQLAlchemy默认自带请求生命周期绑定逻辑，每个请求结束时会自动调用db.session.remove()，把当前请求使用的数据库连接归还到连接池，不需要每次操作后手动调用close。如果你在请求处理中途手动调用close，反而会导致同一请求后续的数据库操作无法获取有效连接。
只有在脱离Web请求上下文、手动创建后台线程执行数据库操作的场景下，才需要在操作完成后手动调用db.session.remove()归还连接。

问题2：是否有方案可在用户离开站点后自动释放数据库连接？ #

不需要专门实现用户离开触发的释放逻辑。
Flask-SQLAlchemy本身的设计就是请求结束立刻归还连接，和用户是否留在站点没有关系——只要请求响应完成，连接就会自动回到连接池复用，不会一直占用。你现在碰到的连接异常问题，是初始化逻辑错误+连接池配置缺失导致的，不是缺少用户离开时的释放逻辑。

问题3：如何彻底修复该偶发的内部服务错误，避免额外升级购买更多worker？ #

按以下步骤修改配置即可，不需要升级付费套餐：

1. 修正应用工厂初始化逻辑，调整./Website/__init__.py代码，把Flask实例创建、db绑定逻辑放到create_app内部，同时补充连接池适配配置：

from flask import Flask
from flask_sqlalchemy import SQLAlchemy
from flask_login import LoginManager

# 先全局创建db实例，不提前绑定app
db = SQLAlchemy()

def create_app():
    app = Flask(__name__)
    app.config['SECRET_KEY'] = 'Something something'
    app.config['SQLALCHEMY_TRACK_MODIFICATIONS'] = False
    app.config['SQLALCHEMY_DATABASE_URI'] = "mysql+mysqlconnector://{username}:{password}@{hostname}/{databasename}".format(
        username="username",
        password="set_MySQL_password",
        hostname="provided_hostname",
        databasename="username$database",
    )
    # 连接池配置适配PythonAnywhere MySQL规则
    app.config['SQLALCHEMY_POOL_SIZE'] = 2  # 单worker维护2个连接，6个worker总连接数12，远低于套餐连接数上限
    app.config['SQLALCHEMY_POOL_RECYCLE'] = 280  # 比MySQL的5分钟空闲断开阈值早20秒回收旧连接，避免拿到服务端关闭的死连接
    app.config['SQLALCHEMY_POOL_PRE_PING'] = True  # 每次从连接池取连接前先做存活检查，自动丢弃失效连接
    app.config['SQLALCHEMY_MAX_OVERFLOW'] = 0  # 禁止超出池大小创建额外连接，避免触发MySQL连接数限制

    # 绑定db到当前app实例
    db.init_app(app)

    from .views import views
    from .auth import auth

    app.register_blueprint(views, url_prefix='/')
    app.register_blueprint(auth, url_prefix='/')

    from .models import User, Project, Candidates, Vote, Ranking

    login_manager = LoginManager()
    login_manager.login_view = 'auth.login'
    login_manager.init_app(app)

    @login_manager.user_loader
    def load_user(id):
        return User.query.get(id)

    # 首次部署时可取消下方注释创建数据库表，执行完成后重新注释即可
    # with app.app_context():
    #     db.create_all()

    return app

2. 确认./app.py代码正确，直接调用create_app获取app实例即可，不需要额外修改：

from Website import create_app

app = create_app()

3. 进入PythonAnywhere的Web管理页面，点击Reload按钮重启Web应用，偶发的连接错误会完全消失。

注意：不要额外添加手动关闭session的逻辑，Flask-SQLAlchemy自带的请求生命周期管理已经可以覆盖所有Web请求场景的连接回收需求，手动干预反而容易引发新的连接问题。

内容的提问来源于stack exchange，提问作者Max de Boer