使用Streamlit+SQLAlchemy连接MySQL时频繁报2013连接丢失错误求助

1. 配置SQLAlchemy连接池的自动重连机制 #

MySQL服务器会自动断开闲置超过wait_timeout或interactive_timeout的连接，这是该错误的常见诱因。给SQLAlchemy引擎添加以下参数，让连接池自动检测并重建失效连接：

• pool_pre_ping=True：每次获取连接前发送测试查询，验证连接有效性，失效则自动重建
• pool_recycle=3600：强制回收闲置超过3600秒的连接（需小于MySQL的超时设置）

示例代码：

from sqlalchemy import create_engine

engine = create_engine(
    "mysql+pymysql://username:password@host:port/dbname?charset=utf8mb4",
    pool_pre_ping=True,
    pool_recycle=3600
)

2. 适配Streamlit的运行机制 #

Streamlit每次交互都会重新执行脚本，若全局创建引擎会导致连接池频繁重建或失效。用@st.cache_resource装饰器缓存数据库引擎，确保连接池稳定复用：

import streamlit as st
from sqlalchemy import create_engine

@st.cache_resource
def get_db_engine():
    return create_engine(
        "mysql+pymysql://username:password@host:port/dbname?charset=utf8mb4",
        pool_pre_ping=True,
        pool_recycle=3600
    )

engine = get_db_engine()

3. 排查数据库端配置与环境 #

• 检查MySQL服务器的wait_timeout和interactive_timeout配置，建议设置为3600秒或更长，避免短时间断开闲置连接。可通过SQL命令查询：
  SHOW VARIABLES LIKE '%timeout%';
• 查看MySQL错误日志，确认是否存在连接被主动断开的记录（如资源不足、防火墙拦截）
• 验证数据库服务器与Streamlit应用的网络稳定性，排查是否有网络波动、防火墙规则变更导致连接中断

4. 优化查询执行 #

即使查询语句逻辑正确，长时间运行或大结果集也可能触发超时：

• 拆分复杂查询，减少单条查询的执行时间
• 对大结果集使用分页获取，避免单次传输数据量过大

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