Python中如何将MySQL连接设为全局？相关疑问与报错求助

一、如何设置全局MySQL连接 #

要在Python里把MySQL连接设为全局，有两种简洁可靠的实现方式：

• 模块级全局变量：在代码文件的顶层初始化连接，函数内部直接引用这个模块级变量即可，无需global关键字（避免不必要的变量作用域混乱）。
  示例代码：

  import mysql.connector
  
  # 模块顶层初始化全局连接
  db_conn = mysql.connector.connect(
      host="你的数据库地址",
      user="用户名",
      password="密码",
      database="目标数据库"
  )
  
  def get_user_list():
      cursor = db_conn.cursor()
      cursor.execute("SELECT id, name FROM users")
      user_data = cursor.fetchall()
      cursor.close()  # 仅关闭游标，不关闭连接
      return user_data
  

• 单例类封装：如果项目复杂度较高，用单例类管理连接更规范，能确保全局始终只有一个连接实例：

  import mysql.connector
  
  class DBConnector:
      _instance = None
  
      def __new__(cls):
          if cls._instance is None:
              cls._instance = super().__new__(cls)
              cls._instance.conn = mysql.connector.connect(
                  host="你的数据库地址",
                  user="用户名",
                  password="密码",
                  database="目标数据库"
              )
          return cls._instance
  
  # 任意函数中调用
  def update_user_status(user_id):
      db = DBConnector()
      cursor = db.conn.cursor()
      cursor.execute("UPDATE users SET status = 1 WHERE id = %s", (user_id,))
      db.conn.commit()
      cursor.close()
  

二、关于connection.close()的问题 #

如果在每个函数里调用connection.close()，连接会被直接关闭，后续再使用这个连接对象会直接报错（比如OperationalError: MySQL Connection not available）。正确的做法是：

• 全局连接保持打开状态，只在程序完全退出前调用一次connection.close()
• 函数内部仅关闭游标（cursor.close()），游标是每次查询/操作后需要释放的资源，连接则可以复用

三、解决‘Unread result found’错误 #

这个错误核心原因是游标中存在未读取完毕的结果集，就被重复使用或执行新操作，常见解决方法：

• 确保读取完所有结果：执行cursor.execute()后，必须调用fetchall()/fetchone()/fetchmany()读取全部结果，再执行下一条SQL或关闭游标。
• 使用缓冲游标：如果查询结果集较大，显式创建缓冲游标可以避免结果残留问题：

  cursor = db_conn.cursor(buffered=True)
  

• 及时关闭游标：每次操作完成后立即关闭游标，下次使用时重新创建新的游标对象，避免旧游标残留未处理结果。

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