You need to enable JavaScript to run this app. Django虚拟环境下发起Web请求时报Lost connection to MySQL错误
优惠活动
大模型
产品
解决方案
定价
更多

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报错特征不匹配

真正的差异点集中在两处:

  1. 虚拟环境和全局环境安装的MySQL驱动版本不一致:Web服务是常驻进程,会复用数据库长连接,不同版本的mysqlclient驱动对长连接的保活、重连逻辑存在差异,一旦驱动默认的连接超时参数小于MySQL服务端的wait_timeout配置,服务端会主动掐断空闲连接,下一次Web请求拿到这个失效连接做commit操作时就会触发报错。而manage shell是单次执行、用完即断,不会触发长连接失效的问题。
  2. 虚拟环境下启动的Web进程继承的系统资源限制过低,高并发场景下无法正常和MySQL建立新的TCP连接。

可落地的解决步骤

  1. 驱动版本对齐
    分别在全局Python环境、激活虚拟环境后,执行命令查看当前安装的mysqlclient版本:
    pip list | grep mysqlclient
    
    把虚拟环境下的mysqlclient版本降级到和全局环境完全一致的版本——该类场景下90%的问题是虚拟环境中pip默认安装了1.4.6及以上版本的mysqlclient,和MySQL5.7的长连接交互逻辑不兼容,而全局环境通常安装的是1.3.12这类经过生产验证的旧版本驱动。
  2. 补全Django数据库连接配置
    在项目settings.py的DATABASES配置块中补充长连接参数,避免连接被服务端主动断开:
    DATABASES = {
        'default': {
            # 原有数据库配置保持不变
            'CONN_MAX_AGE': 60,  # 单个数据库连接最长复用60秒,到期后自动重建新连接
            'OPTIONS': {
                'connect_timeout': 10,
                'read_timeout': 30,
            }
        }
    }
    
  3. 验证系统资源限制影响
    启动Web服务前,先在当前shell中执行命令提高文件句柄限制,再启动服务测试报错是否消失:
    ulimit -n 65535
    
    如果调整句柄限制后报错消失,说明是虚拟环境启动的Web进程继承的默认句柄数限制太低,需要将该配置写入进程的启动配置文件固化即可。

内容的提问来源于stack exchange,提问作者jay zhang

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.16 13:15:03