StaleConnectionError源于MySQL空闲超时后连接池仍复用失效socket，根治方案是组合启用pool_pre_ping=True（每次取连接前SELECT 1探活）与pool_recycle=3600（确保早于wait_timeout回收）。
StaleConnectionError 通常不是连接真“断了”，而是连接池里存了个过期的 socket
这个错误多数出现在 MySQL 连接空闲超时（wait_timeout）后，SQLAlchemy 仍试图复用连接池中已失效的连接。MySQL 默认 wait_timeout=28800（8 小时），但很多云数据库（如阿里云 RDS、AWS RDS）会设成更短（比如 60–300 秒），而 SQLAlchemy 默认不校验连接有效性。
关键修复：启用连接池预检 + 合理配置 pool_recycle
不要只靠 pool_recycle 硬回收，得配合 pool_pre_ping=True 才能真正防 stale。两者组合才是稳妥方案：
-
pool_pre_ping=True：每次从连接池取连接前，先发一个SELECT 1探活，失败则自动丢弃并新建连接 -
pool_recycle=3600（建议值）：强制连接在 1 小时内重连一次，避免依赖 MySQL 的 wait_timeout 值——因为不同环境该值不可控 - 避免设
pool_recycle大于 MySQL 的wait_timeout，否则 pre_ping 可能还没触发就已失效 - 若用的是
mysql+pymysql，确认 PyMySQL 版本 ≥ 1.0.2（旧版 pre_ping 有 bug）
常见误配：SQLAlchemy URL 里加 ?charset=utf8mb4 却漏掉 autocommit=false
某些场景下（尤其是长事务或手动 commit 控制），如果连接被池回收又重用，残留的事务状态可能干扰后续查询，表现为看似随机的 StaleConnectionError 或 LockWaitTimeout。这不是连接本身问题，而是状态污染：
kashen-mysql DDLtoExcel
下载
解析 MySQL 8.0 的 DDL 脚本，并将表结构导出为 Excel 格式。适用于用户需将 MySQL 的 `CREATE TABLE` 语句转换为结构化的 Excel 文件场景，导出内容包含字段名、数据类型、长度及精度等信息。支持多张表的批量处理，每张表对应 Excel 中的一个独立工作表。适用于数据库文档编写、数据字典生成及模式分析等任务。
- 显式关闭 autocommit：
mysql+pymysql://...?autocommit=false - 确保所有 session 操作都走
session.commit()/session.rollback()，别依赖隐式提交 - 避免在非 Flask/Django 环境中直接复用全局 engine —— 多线程/协程下容易混用连接
生产环境必须检查的三项 MySQL 配置
光调 SQLAlchemy 不行，MySQL 侧几个参数直接影响 pre_ping 效果：
立即学习“Python免费学习笔记（深入）”；
- 查当前
wait_timeout：SHOW VARIABLES LIKE 'wait_timeout';，若 ≤ 60，pool_recycle必须设为 - 确认
interactive_timeout和wait_timeout一致，否则交互式连接行为不一致 - 禁用
skip-name-resolve（如果开启），否则 pre_ping 的 DNS 解析可能超时，反致连接卡死
StaleConnectionError 表面是连接问题，实际是连接池策略、MySQL 超时设置、应用事务管理三者没对齐的结果。最容易被忽略的是 pre_ping 和 pool_recycle 的协同逻辑——单独开任一个都不够稳。
