执行MySQL插入时遇2006错误(MySQL server has gone away)求解决

以下是针对该错误的可行解决办法：

• 处理连接超时问题
  MySQL会自动关闭长时间闲置的连接（默认wait_timeout为8小时），如果程序长时间未执行数据库操作，连接会失效。可以在执行操作前验证连接状态，失效则自动重连：

  def get_valid_cursor():
      global conn  # 假设conn是全局数据库连接对象
      try:
          # 用ping操作验证连接，失效则自动重连
          conn.ping(reconnect=True)
      except:
          # 重新建立连接
          conn = mysql.connector.connect(
              host='你的主机地址',
              user='你的用户名',
              password='你的密码',
              database='你的数据库名'
          )
      return conn.cursor()
  
  # 先获取有效游标再执行插入
  cursor = get_valid_cursor()
  cursor.execute("INSERT INTO email_logs (message_id,email_subject,from_address,to_address,email_html_content,email_content) VALUES (%s,%s,%s,%s,%s,%s)",
                  (message_id, subject, from_email_address, to_address, email_html_content, str(email_content)))
  scrapper_email_id = cursor.lastrowid
  print("scrapper_email_id: " + str(scrapper_email_id))
  

  主流MySQL Python驱动（如mysql-connector-python、pymysql）都支持类似的自动重连机制，具体语法可参考对应驱动文档。

• 检查插入数据的大小
  如果email_html_content或email_content内容过大，超过MySQL的max_allowed_packet配置（默认4MB），会触发该错误。解决方式：

  1. 临时调整MySQL参数：执行SET GLOBAL max_allowed_packet=67108864;（设置为64MB），重启MySQL后需修改my.cnf/my.ini文件，添加max_allowed_packet=64M来永久生效。
  2. 对过大的内容做压缩或分片处理（业务允许的前提下）。

• 优化连接生命周期
  避免长期持有全局连接，尤其是在长时间运行的脚本或服务中。建议每次操作前建立连接，完成后立即关闭：

  # 每次操作新建连接
  conn = mysql.connector.connect(
      host='你的主机地址',
      user='你的用户名',
      password='你的密码',
      database='你的数据库名'
  )
  cursor = conn.cursor()
  try:
      cursor.execute("INSERT INTO email_logs (...) VALUES (%s,%s,%s,%s,%s,%s)", 
                      (message_id, subject, from_email_address, to_address, email_html_content, str(email_content)))
      conn.commit()
      scrapper_email_id = cursor.lastrowid
      print(f"scrapper_email_id: {scrapper_email_id}")
  finally:
      cursor.close()
      conn.close()
  

  虽然频繁建连有少量性能开销，但能彻底避免闲置连接被服务器断开的问题。

• 排查网络问题
  防火墙、路由器的超时设置可能主动断开空闲TCP连接：

  • 检查服务器与客户端之间的防火墙规则，是否存在短时间断开闲置连接的配置。
  • 在MySQL连接参数中添加超时设置，比如mysql-connector-python可设置connection_timeout=30，部分驱动支持配置TCP keepalive参数。

• 检查MySQL服务状态
  确认MySQL服务是否正常运行，查看服务器上的MySQL错误日志（通常在/var/log/mysql/error.log或数据目录下的hostname.err文件），排查是否有服务崩溃、重启的异常记录。

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