MySQL Python 连接器不自动继承 USE database 的上下文，执行多语句时需显式遍历结果生成器，否则后续查询（如 SELECT）不会实际执行。
mysql python 连接器不自动继承 `use database` 的上下文，执行多语句时需显式遍历结果生成器，否则后续查询（如 `select`）不会实际执行。
在使用 mysql-connector-python 时，一个常见误区是认为像 GUI 工具（如 MySQL Workbench、DBeaver）或命令行客户端那样，用分号连接多个语句（例如 'USE my_db; SELECT * FROM my_table;'）就能自然切换数据库并执行后续查询。但事实并非如此——MySQL 连接器对多语句执行采取惰性、迭代式处理机制，而非隐式顺序执行。
✅ 正确做法一：分步执行（推荐）
最简洁、可靠的方式是将 USE 和查询拆分为独立调用：
cursor.execute('USE my_db')
cursor.execute('SELECT * FROM my_table')
rows = cursor.fetchall()
print(rows)
这种方式逻辑清晰、无需处理生成器，且完全规避了多语句的复杂性，适用于绝大多数场景。
✅ 正确做法二：显式遍历多语句结果（仅当必须用 multi=True 时）
若因业务需要必须在单次 execute() 中提交多个语句（如批量初始化脚本），则必须启用 multi=True 并完整遍历返回的生成器：
安装、修复、更新或打包一个基于 Python 和 PyMySQL 实现的 Windows `mysql` 命令。适用于用户希望在 PowerShell/CMD 中输入 `mysql` 时重定向到 Python 实现、需要交互式输入 MySQL 连接信息、需要同步到当前用户本地 bin 目录，或需要将该能力封装成可公开复用的 Codex skill。
results = cursor.execute('USE my_db; SELECT * FROM my_table;', multi=True)
for result in results:
if result.with_rows:
rows = result.fetchall()
print("Query returned:", rows)
else:
# 处理无结果集的语句（如 USE、CREATE、INSERT 等）
print("Statement executed successfully (no result set)")
⚠️ 关键注意：
-
cursor.execute(..., multi=True)返回的是生成器（generator），不是结果本身； - 不遍历该生成器 → 后续语句根本不会执行（
USE可能生效，但SELECT被跳过）； -
USE语句本身无结果集（result.with_rows == False），因此需通过if result.with_rows判断是否需取数。
? 补充说明：为什么 GUI 工具“看起来”不同？
GUI 客户端和 MySQL CLI 在底层会对分号分隔的语句进行预解析，并为每个子语句自动建立/维护会话上下文（包括默认数据库）。而 mysql-connector-python 更贴近协议层行为：它将整个字符串作为多语句请求发送，服务端虽会依次执行，但客户端必须主动拉取每一结果集才能触发完整流程。
✅ 最佳实践建议
- 优先使用
cursor.execute('USE db_name')显式切换库，再执行业务查询； - 避免在应用逻辑中依赖
multi=True实现数据库上下文切换； - 若需跨库查询，直接使用限定表名（如
SELECT * FROM other_db.table_name）更安全、可读性更高； - 所有
multi=True场景务必配合生成器遍历，切勿忽略返回值。
遵循以上原则，即可让 Python 连接器的行为与预期一致，同时保持代码健壮性与可维护性。
