Python中SQLite嵌套查询循环仅执行一次的问题排查

问题本质 #

你碰到的核心问题是数据库游标资源冲突：循环内复用同一个游标执行统计查询时，外层遍历用户数据的游标结果集会被内层查询覆盖，外层循环只能读取到第一条用户数据后就没有后续结果了，所以循环只跑了一次，且无语法报错。

两种可行解决方案 #

• 方案1：用独立游标处理内层统计查询
  给外层用户查询和内层文档统计分别分配独立的游标，避免结果集覆盖。以Python为例：

  # 外层查询用户数据的游标
  outer_cursor = db_conn.cursor()
  outer_cursor.execute("SELECT id, email FROM contact JOIN REX ON 你的关联条件 WHERE 你的筛选条件")
  users = outer_cursor.fetchall()
  
  # 内层统计用独立游标
  inner_cursor = db_conn.cursor()
  for user in users:
      user_id = user[0]
      inner_cursor.execute("SELECT COUNT(*) FROM documents WHERE user_id = %s", (user_id,))
      doc_count = inner_cursor.fetchone()[0]
      print(f"用户{user[1]}的文档数量：{doc_count}")
  
  # 用完关闭游标
  inner_cursor.close()
  outer_cursor.close()
  

• 方案2：用单条SQL一次性统计（更高效）
  直接通过JOIN+GROUP BY完成所有用户的文档统计，减少数据库交互次数，从根源避免游标冲突：

  SELECT c.id, c.email, COUNT(d.id) AS doc_count
  FROM contact c
  JOIN REX r ON c.关联字段 = r.关联字段  -- 替换成你原来的关联条件
  LEFT JOIN documents d ON c.id = d.user_id  -- LEFT JOIN保留无文档的用户（可选）
  WHERE 你的筛选条件
  GROUP BY c.id, c.email;
  

  执行这条SQL后直接拿到所有用户的文档数，不需要循环查询，性能更优。

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