SQLAlchemy本身不提供自动重连，而是通过pool_pre_ping与pool_recycle协同实现可靠连接管理：前者每次取连接前执行SELECT 1探测存活，后者强制连接在3600秒后回收，两者配合可有效避免MySQL因wait_timeout（默认8小时）导致的“Lost connection”错误。
SQLAlchemy 本身不提供“自动重连”功能，而是靠连接池 + 异常捕获 + 重试逻辑协同实现；直接设 pool_recycle 或 pool_pre_ping 是最常用且有效的做法，但必须配对使用事务处理逻辑，否则仍会抛出 sqlalchemy.exc.InvalidRequestError 或底层 MySQLdb._exceptions.OperationalError。
为什么 MySQL 连接会断开？
MySQL 默认 wait_timeout 是 8 小时，空闲连接会被服务端主动关闭；SQLAlchemy 的连接池若复用已失效的连接，下一次执行 execute() 或 commit() 时就会报错。常见错误信息包括：Lost connection to MySQL server during query、MySQL server has gone away。
这不是 SQLAlchemy bug，而是网络/数据库配置与应用层协作的问题。
-
pool_recycle：强制连接在指定秒数后被回收（例如设为 3600），避免复用超时连接 -
pool_pre_ping：每次从连接池取出连接前，先发一个SELECT 1探测是否存活，失败则自动重建连接 - 两者可共存，但
pool_pre_ping=True更可靠，尤其适合连接空闲时间不可控的场景
如何配置 engine 实现可靠重连？
关键不是加个参数就完事，而是组合设置 + 避免长事务阻塞连接池。以下是最小可行配置：
立即学习“Python免费学习笔记（深入）”；
from sqlalchemy import create_engine <p>engine = create_engine( "mysql+pymysql://user:pass@localhost/dbname", pool_pre_ping=True, # 必须开启 pool_recycle=3600, # 可选，但建议设（略小于 MySQL wait_timeout） pool_size=5, max_overflow=10, echo=False )
注意：pool_pre_ping 会带来微小延迟（每次取连接多一次 round-trip），但在绝大多数 Web 或任务型应用中可忽略；它比手动捕获异常再重试更简洁、更底层。
- 不要设
pool_recycle=0—— 这等于禁用连接复用，性能暴跌 - 不要只依赖
pool_recycle而不设pool_pre_ping—— 时间误差或网络抖动仍会导致失败 - 如果用的是
PyMySQL，确保版本 ≥ 1.0.2；老版本在连接断开后可能无法正确重连
session 执行时仍报错怎么办？
即使 engine 配置正确，session.commit() 或 session.execute() 仍可能抛出连接异常，因为 pool_pre_ping 只保障“取连接时有效”，不保证“整个事务期间不断开”。这时需在业务层做简单重试：
from sqlalchemy.exc import OperationalError <p>for i in range(3): try: session.commit() break except OperationalError as e: if "MySQL server has gone away" in str(e) or "Lost connection" in str(e): session.rollback() if i == 2: raise else: raise</p>
这不是兜底万能方案，而是补足 pool_pre_ping 的最后防线。重点在于：必须 session.rollback() 后再重试，否则 session 状态混乱。
- 不要在
except里直接session.close()—— 这会让后续查询失效 - 不要对所有
OperationalError都重试，只针对明确的断连类错误 - 异步应用（如 FastAPI + asyncpg）需换用
aiomysql或asyncmy，其重连机制完全不同
验证配置是否生效？
最直接的办法是人为制造断连：临时把 MySQL 的 wait_timeout 改成 10 秒，然后让应用空闲超过 10 秒再发起查询。若没报错，说明 pool_pre_ping 生效了。
也可以查日志：echo=True 时能看到类似 SELECT 1 的探测语句；生产环境关掉 echo，但可通过 logging.getLogger('sqlalchemy.engine') 捕获 INFO 级日志确认探测行为。
-
pool_pre_ping的探测发生在每次connection = engine.connect()或session.begin()时，不是定时轮询 - 连接池大小和并发量不匹配时，哪怕配置再好也会因等待连接而超时，需结合
timeout和监控调整 - 容器化部署中，MySQL 重启或 Service IP 变更会导致 DNS 缓存问题，此时需要额外加
connect_args={"read_timeout": 10, "write_timeout": 10}
