Django虚拟环境下发起Web请求时报Lost connection to MySQL错误
虚拟环境下Django触发MySQL 2013 Lost connection报错排查方案
问题边界特征
当前故障有明确的边界条件,可直接缩小排查范围:
- 全局Python环境下启动Web服务,所有接口运行正常
- 切换至路径为
/home/jay/fs_work_django_dev的虚拟环境时,发起Web请求就会在事务commit阶段触发(2013, 'Lost connection to MySQL server during query')报错 - 同一虚拟环境下,通过
manage.py shell执行模型增删改查操作完全正常
根因拆解
首先排除无意义的排查方向:
- 排除MySQL服务端权限、网络连通性问题:同虚拟环境下manage shell能正常读写数据库,说明账号、网络端口、防火墙规则全部正常
- 排除SQL语句本身问题:报错触发点在事务提交环节,不是SQL执行解析环节,且相同逻辑在shell环境能正常跑通
- 排除MySQL连接数打满问题:如果是连接数超限,报错特征是
Too many connections,和当前2013报错特征不匹配
真正的差异点集中在两处:
- 虚拟环境和全局环境安装的MySQL驱动版本不一致:Web服务是常驻进程,会复用数据库长连接,不同版本的mysqlclient驱动对长连接的保活、重连逻辑存在差异,一旦驱动默认的连接超时参数小于MySQL服务端的
wait_timeout配置,服务端会主动掐断空闲连接,下一次Web请求拿到这个失效连接做commit操作时就会触发报错。而manage shell是单次执行、用完即断,不会触发长连接失效的问题。 - 虚拟环境下启动的Web进程继承的系统资源限制过低,高并发场景下无法正常和MySQL建立新的TCP连接。
可落地的解决步骤
- 驱动版本对齐
分别在全局Python环境、激活虚拟环境后,执行命令查看当前安装的mysqlclient版本:
把虚拟环境下的mysqlclient版本降级到和全局环境完全一致的版本——该类场景下90%的问题是虚拟环境中pip默认安装了1.4.6及以上版本的mysqlclient,和MySQL5.7的长连接交互逻辑不兼容,而全局环境通常安装的是1.3.12这类经过生产验证的旧版本驱动。pip list | grep mysqlclient - 补全Django数据库连接配置
在项目settings.py的DATABASES配置块中补充长连接参数,避免连接被服务端主动断开:DATABASES = { 'default': { # 原有数据库配置保持不变 'CONN_MAX_AGE': 60, # 单个数据库连接最长复用60秒,到期后自动重建新连接 'OPTIONS': { 'connect_timeout': 10, 'read_timeout': 30, } } } - 验证系统资源限制影响
启动Web服务前,先在当前shell中执行命令提高文件句柄限制,再启动服务测试报错是否消失:
如果调整句柄限制后报错消失,说明是虚拟环境启动的Web进程继承的默认句柄数限制太低,需要将该配置写入进程的启动配置文件固化即可。ulimit -n 65535
内容的提问来源于stack exchange,提问作者jay zhang
相关产品推荐
相关产品推荐

