
本文探讨在轻负载 fastapi 应用中因数据库连接空闲超时导致的 mysql 连接丢失问题,指出强制重启 gunicorn 工作进程并非合理方案,并提供基于 sqlalchemy 连接池的健壮、专业级解决方案。
本文探讨在轻负载 fastapi 应用中因数据库连接空闲超时导致的 mysql 连接丢失问题,指出强制重启 gunicorn 工作进程并非合理方案,并提供基于 sqlalchemy 连接池的健壮、专业级解决方案。
在使用 FastAPI 部署于 Gunicorn 的生产环境中,若应用负载较低(如数小时无请求),常会遇到类似 MySQL server has gone away 或 Lost connection to MySQL server during query 的错误。这并非 FastAPI 或 Gunicorn 的缺陷,而是底层数据库连接因网络中间件(如云服务商 LB、NAT 网关)或 MySQL 服务端 wait_timeout 参数(默认通常为 28800 秒,即 8 小时;但某些托管服务可能设为更短,如 300–600 秒)主动关闭空闲连接所致。
你提出的“每小时 SIGTERM 杀死 worker”方案虽能临时规避问题,但存在严重隐患:
- ✅ 表面“生效”,但属于掩盖而非修复;
- ❌ 可能中断正在处理的 HTTP 请求,造成响应截断、客户端超时、事务不完整;
- ❌ 丢失内存中未持久化的状态(如缓存、临时计算结果);
- ❌ 增加进程启停开销,降低系统稳定性与可观测性;
- ❌ 多 worker 场景下无法保证均匀轮转,易引发瞬时并发压力波动。
真正可靠的解法,是交由 SQLAlchemy 异步引擎(create_async_engine)自身管理连接生命周期。 关键在于两个核心参数的协同配置:
✅ 推荐配置:pool_pre_ping + pool_recycle
from sqlalchemy.ext.asyncio import create_async_engine
DATABASE_URL = "mysql+aiomysql://user:pass@host:3306/db?charset=utf8mb4"
engine = create_async_engine(
DATABASE_URL,
echo=False, # 生产环境建议关闭
pool_pre_ping=True, # ✅ 每次取连接前执行轻量 ping(SELECT 1)
pool_recycle=300, # ✅ 连接复用上限设为 5 分钟(建议略小于 DB wait_timeout)
pool_size=10, # 根据并发预期调整
max_overflow=20, # 高峰期可临时扩容
pool_timeout=30, # 获取连接超时(秒)
)-
pool_pre_ping=True是最推荐的首选项:它在每次从连接池取出连接前,自动执行一次SELECT 1探活。若连接已失效(如被 MySQL 主动断开),则立即丢弃该连接并新建一个,对业务逻辑完全透明,且无性能负担。 -
pool_recycle=300(5 分钟)确保连接不会长期驻留,避免因网络设备静默丢包或服务端超时导致的“僵尸连接”。注意:此值应严格小于 MySQL 的wait_timeout(可通过SHOW VARIABLES LIKE 'wait_timeout';查看),建议预留 60–120 秒缓冲。
⚠️ 注意事项与验证建议
-
不要在路由装饰器中手动 close/rollback:连接应由依赖注入(如 FastAPI 的
Depends(get_db))和上下文管理器(async with session.begin():)自动管理。手动干预易破坏连接池逻辑。 -
避免混用同步/异步驱动:确保使用
aiomysql(非pymysql)或asyncmy,并匹配create_async_engine。 -
验证是否生效:启用
echo=True并观察日志中是否出现SELECT 1查询;模拟空闲后发起请求,确认不再报错。 -
Gunicorn 配置补充:若仍需增强健壮性,可配合
--max-requests=1000 --max-requests-jitter=100(限制单 worker 处理请求数),但优先级远低于连接池调优。
总结:数据库连接空闲失效是标准运维场景,不应通过粗暴终止进程来“绕过”。通过 pool_pre_ping + 合理 pool_recycle 组合,即可让 SQLAlchemy 自动、安全、高效地维护健康连接,这是符合云原生与高可用设计原则的专业实践。


















