Flask+XAMPP-MySQL授权权限时触发MySQLdb.OperationalError(2006)

环境与问题概述 #

• 技术栈：Python + Flask + XAMPP-MySQL，使用flask_mysqldb库
• 应用流程：用户注册→数据存入maindb→创建专属数据库及用户→为该用户授予新库全权限
• 异常现象：注册数据存储、新库/用户创建均正常，但授权步骤失败，抛出MySQLdb.OperationalError: (2006, '')
• 触发背景：重装XAMPP并将MySQL端口修改为16000后出现此问题，此前代码运行正常
• 错误堆栈链路：
  1. main.py中return registeration(db)
  2. utility.py中db.create_user(dbAdi, dbUser, dbPassword)
  3. database.py中self.cursor.execute(sorguForPrivileges)

排查方向与解决方案 #

1. 端口配置一致性检查 #

• 确保所有数据库连接（包括执行授权操作的连接）都明确指定了新端口16000，避免部分用默认3306、部分用16000的混合配置
• 检查database.py中DataBase类的连接参数，确认port=16000已正确配置
• 验证端口监听状态：
  • Windows：执行netstat -ano | findstr 16000，确认有LISTENING状态的进程
  • Linux/Mac：执行lsof -i :16000，确认MySQL服务在该端口监听

2. 连接有效性验证 #

• (2006, '')本质对应MySQL server has gone away错误，大概率是执行授权语句时连接已断开
• 在database.py的create_user方法中，执行授权语句前添加连接保活逻辑：

  self.connection.ping(reconnect=True)
  

• 检查configure_db方法是否存在连接未正确保持的情况，比如过早关闭连接

3. 主账号权限确认 #

• 重装XAMPP后，原操作账号的权限可能被重置，需要确保主账号拥有CREATE USER和GRANT OPTION权限
• 登录MySQL执行以下语句重新授权：

  GRANT CREATE USER, GRANT OPTION, ALL PRIVILEGES ON *.* TO 'your_main_user'@'localhost' IDENTIFIED BY 'your_password';
  FLUSH PRIVILEGES;
  

4. 授权SQL语句语法校验 #

• 检查sorguForPrivileges变量对应的SQL语句是否正确，重点确认：
  • 数据库名、用户名是否正确引用（含特殊字符时需用反引号包裹）
  • 授权范围是否为new_db_name.*（而非全局*.*）
• 标准授权语句格式参考：

  GRANT ALL PRIVILEGES ON `new_db_name`.* TO 'new_user'@'localhost' IDENTIFIED BY 'new_password';
  FLUSH PRIVILEGES;
  

5. XAMPP MySQL超时配置调整 #

• 检查my.ini（Windows）或my.cnf（Linux/Mac）中的超时参数，若wait_timeout或interactive_timeout设置过短，会导致连接提前断开
• 修改配置文件，增大超时值（例如设置为300秒）：

  wait_timeout = 300
  interactive_timeout = 300
  

• 修改后重启XAMPP的MySQL服务

内容的提问来源于stack exchange，提问作者mkrdmn