Python 打印 MySQL 版本信息：TaoToken 统一 Key 通道下的连接自检与版本探测

1. Python 打印 MySQL 版本信息到底在解决什么问题

Python 打印 MySQL 版本信息，本质上是让脚本在建立连接后主动向服务端要一次「你是什么版本」的答案，再把结果落到日志或终端里。它看起来只是一行select version()，但在真实项目里，这一步往往决定了后面几小时的排查方向：驱动装没装对、字符集是否匹配、SQL 语法能不能用、某个函数在当前版本是否存在，全都依赖这个版本号。适合谁？适合刚接手一套陌生数据库的运维、写数据同步脚本的后端、做自动化测试的同学，以及任何需要在 CI 里做环境自检的人。

我见过太多人卡在第一步：脚本第一行写#!/usr/local/python，运行直接报错，还不知道为什么。这其实是 shebang 路径写错了——/usr/local/python通常不是一个可执行文件，而是目录。正确写法要么用#!/usr/bin/env python，让系统去 PATH 里找解释器，要么写清楚真实路径如#!/usr/bin/python3。这个坑和 MySQL 本身无关，但它经常和「打印版本失败」混在一起，让人误以为是数据库问题。

再往下，MySQLdb.connect("192.168.74.130","root","l","")这种写法在 Python 2 时代很常见，print "Database version : %s " % data也是 Python 2 语法。放到 Python 3 里，print必须加括号，MySQLdb也基本被PyMySQL或mysql-connector-python取代。所以「打印 MySQL 版本信息」这件事，表面是查版本，实际是一次完整的连接自检：解释器对不对、驱动装没装、网络通不通、账号密码对不对、服务端版本是多少。

而当我们把连接的目标 endpoint 换到 TaoToken 统一 Key 通道后，这件事又多了一层意义：它变成了一次通道可用性验证。你不再只是确认「MySQL 活着」，而是确认「我通过统一入口能稳定拿到服务端响应」。这对多环境、多模型的团队尤其有用——一个 Key、一个 Base URL，就能把版本探测这类自检动作标准化。

所以这篇不会只给你一段select version()就结束。我会从环境准备讲到可复制的连接配置，再演示把 endpoint 指向 TaoToken 后跑一次版本探测，最后把常见报错一个个拆开。你照着做，能拿到一个真正能在自己机器上跑通的自检脚本。

2. TaoToken 统一 Key 通道的前置准备与 Python 环境搭建

在写代码之前，先把两件事理清楚：Python 侧的驱动选型，以及 TaoToken 侧的 Key 与 Base URL 怎么拿。这两步没做好，后面select version()一定报错，而且报错信息往往指向错误的方向。

先说驱动。Python 连 MySQL 主流有三条路：PyMySQL（纯 Python，安装最省事）、mysql-connector-python（官方出品）、MySQLdb（即 mysqlclient，需要编译，Windows 上容易翻车）。如果你只是要做版本探测这种轻量自检，我建议直接用PyMySQL，一条pip install pymysql就完事，不依赖系统里的 MySQL 开发库。命令如下：

python3 -m pip install pymysql

装完可以顺手验证一下：

python3 -c "import pymysql; print(pymysql.__version__)"

能打印出版本号，说明驱动就位。这一步很关键，因为后面所有连接代码都建立在它之上。

再说 TaoToken。TaoToken 提供的是统一 Key 通道，也就是说你不需要为每个模型或每个服务单独记一套凭证，而是用一个 Key 走一个 Base URL。对做版本探测这种自检来说，好处是配置项收敛：Base URL 固定、Key 固定、Model ID 按需指定。你需要去控制台创建一个 API Key，入口在这里：

• 控制台：https://taotoken.net/console?utm_source=taotoken_aicg_blog_end&utm_content=console&utm_campaign=rewrite
• API Keys 管理：https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=api-keys&utm_campaign=rewrite

拿到 Key 之后，记住三个要素，后面配置里会反复出现：Base URL 是https://taotoken.net/api，Key 形如sk-开头的一串字符，Model ID 则根据你实际要调用的能力填写。这三件套是 TaoToken 接入的通用范式，无论你是做版本探测、模型对话还是长期编码任务，配置结构都一样。

这里要提醒一句：不要把 Key 硬编码进脚本再提交到 Git。正确做法是走环境变量。Linux/macOS 下：

export TAOTOKEN_API_KEY="sk-你的key" export TAOTOKEN_BASE_URL="https://taotoken.net/api"

Windows PowerShell：

$env:TAOTOKEN_API_KEY="sk-你的key" $env:TAOTOKEN_BASE_URL="https://taotoken.net/api"

这样脚本里用os.environ.get("TAOTOKEN_API_KEY")读取，既安全又方便在不同环境切换。环境准备好之后，我们就可以进入真正的连接配置环节了。

3. 可复制的连接配置与版本查询代码

这一节是全文的核心，我会给你一份可以直接复制运行的配置，包含连接参数、版本查询语句、异常处理，以及把 endpoint 指向 TaoToken 的写法。先看完整的 Python 脚本，再逐段解释。

#!/usr/bin/env python3 # -*- coding: utf-8 -*- import os import pymysql from pymysql import err # 从环境变量读取，避免硬编码 DB_HOST = os.environ.get("DB_HOST", "127.0.0.1") DB_PORT = int(os.environ.get("DB_PORT", "3306")) DB_USER = os.environ.get("DB_USER", "root") DB_PASS = os.environ.get("DB_PASS", "") DB_NAME = os.environ.get("DB_NAME", "") # TaoToken 统一 Key 通道配置 TAOTOKEN_BASE_URL = os.environ.get("TAOTOKEN_BASE_URL", "https://taotoken.net/api") TAOTOKEN_API_KEY = os.environ.get("TAOTOKEN_API_KEY", "") def probe_mysql_version(): conn = None try: conn = pymysql.connect( host=DB_HOST, port=DB_PORT, user=DB_USER, password=DB_PASS, database=DB_NAME or None, charset="utf8mb4", connect_timeout=5, read_timeout=10, cursorclass=pymysql.cursors.DictCursor, ) with conn.cursor() as cursor: cursor.execute("SELECT VERSION() AS server_version") row = cursor.fetchone() print("Database version : %s" % row["server_version"]) cursor.execute("SELECT @@character_set_server AS cs, @@collation_server AS coll") meta = cursor.fetchone() print("Charset : %s / %s" % (meta["cs"], meta["coll"])) except err.OperationalError as e: print("[OperationalError] 连接或权限问题: %s" % e) except err.ProgrammingError as e: print("[ProgrammingError] SQL 语法或对象问题: %s" % e) finally: if conn: conn.close() if __name__ == "__main__": probe_mysql_version()

这段代码有几个设计点值得说。第一，connect_timeout和read_timeout一定要设，否则网络不通时脚本会挂很久，自检脚本最忌讳卡死。第二，cursorclass=DictCursor让结果以字典返回，取row["server_version"]比取下标更清晰，也不怕列顺序变化。第三，异常分了两类：OperationalError通常是网络、账号、权限问题，ProgrammingError通常是 SQL 写错或库不存在，分开打印能让你一眼定位。

现在把 endpoint 指向 TaoToken。TaoToken 的 Base URL 是https://taotoken.net/api，在配置里体现为统一入口。如果你用的是支持自定义 Base URL 的客户端或 SDK，把base_url设成它、api_key设成你的 Key、model设成对应 Model ID 即可。以配置文件形式表达，结构如下（JSON 示例，路径按你项目实际位置放）：

{ "base_url": "https://taotoken.net/api", "api_key": "sk-你的key", "model": "你的ModelID", "timeout": 30 }

如果你用的是 TOML 风格配置（比如某些 CLI 工具），等价写法：

[taotoken] base_url = "https://taotoken.net/api" api_key = "sk-你的key" model = "你的ModelID" timeout = 30

注意这里的三件套必须齐全：Base URL、Key、Model ID。少任何一个，请求都会失败。很多人只填了 Key 和 Base URL，忘了 Model ID，结果报model not found，还以为是 Key 失效。这一点在后面的排错章节会再展开。

把上面的脚本保存为probe_mysql.py，先设置好数据库环境变量，再运行：

export DB_HOST=127.0.0.1 export DB_PORT=3306 export DB_USER=root export DB_PASS=yourpassword python3 probe_mysql.py

如果一切正常，你会看到类似Database version : 8.0.36和字符集信息。这就是一次完整的版本探测。接下来我们看怎么把 TaoToken 通道也纳入这次验证。

4. 验证请求与成功结果：把 endpoint 改到 TaoToken 后跑一次探测

上一节的脚本验证的是「Python 能不能连上 MySQL 并拿到版本」。这一节我们要验证的是「TaoToken 统一 Key 通道是否可用」。这两件事可以合并成一次自检：先确认通道能响应，再确认数据库能响应。

TaoToken 提供了模型对话入口，你可以先用它做一次最轻量的连通性验证，确认 Key 和 Base URL 没问题：

• 模型对话：https://taotoken.net/model-chat?utm_source=taotoken_aicg_blog_end&utm_content=model-chat&utm_campaign=rewrite

在对话页里发一句简单的话，比如「返回当前时间」，如果能正常回复，说明 Key、Base URL、Model ID 三件套配置正确。这一步相当于给通道做一次「心跳检测」，比直接上代码更快定位问题。

通道确认后，回到 Python 侧。下面这段代码演示如何用统一 Key 通道的配置去发起一次请求，并把返回结果打印出来，作为通道可用的证据：

#!/usr/bin/env python3 # -*- coding: utf-8 -*- import os import json import urllib.request BASE_URL = os.environ.get("TAOTOKEN_BASE_URL", "https://taotoken.net/api") API_KEY = os.environ.get("TAOTOKEN_API_KEY", "") MODEL_ID = os.environ.get("TAOTOKEN_MODEL", "你的ModelID") def probe_channel(): url = BASE_URL.rstrip("/") + "/v1/chat/completions" payload = { "model": MODEL_ID, "messages": [ {"role": "user", "content": "只回复两个字：可用"} ], "max_tokens": 16, } data = json.dumps(payload).encode("utf-8") req = urllib.request.Request( url, data=data, headers={ "Content-Type": "application/json", "Authorization": "Bearer %s" % API_KEY, }, method="POST", ) try: with urllib.request.urlopen(req, timeout=30) as resp: body = resp.read().decode("utf-8") result = json.loads(body) content = result["choices"][0]["message"]["content"] print("Channel OK, reply: %s" % content) except urllib.error.HTTPError as e: print("HTTPError %s: %s" % (e.code, e.read().decode("utf-8"))) except Exception as e: print("Request failed: %s" % e) if __name__ == "__main__": probe_channel()

运行前设置好环境变量：

export TAOTOKEN_API_KEY="sk-你的key" export TAOTOKEN_BASE_URL="https://taotoken.net/api" export TAOTOKEN_MODEL="你的ModelID" python3 probe_channel.py

成功时你会看到Channel OK, reply: 可用。这就是通道可用的直接证据。注意choices[0].message.content这个取值路径，如果返回结构不对，通常会报KeyError: 'choices'，说明响应体不是预期的对话格式，多半是 URL 拼错或 Model ID 不对。

把两段脚本合起来看，你就得到了一套完整的自检流程：先跑probe_channel.py确认 TaoToken 通道活着，再跑probe_mysql.py确认数据库活着。两个都通过，说明你的开发环境在「通道 + 数据源」两个维度都是健康的。这套流程放进 CI 的 smoke test 里非常合适，每次部署前跑一遍，能挡掉大量低级故障。

如果你后续要做长期编码或 Agent 类任务，可以把这套自检扩展成定时任务，配合 Coding Plan 使用：

• Coding Plan：https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=coding-plan&utm_campaign=rewrite

这样通道可用性和数据库可用性都能被持续监控，而不是等到线上出问题才回头查。

5. 本篇常见报错排查：401、local proxy failed、reading choices、OAuth

自检脚本跑不通时，报错信息往往很吓人，但归类之后其实就那么几种。这一节我把最常见的四类报错拆开讲，每一类都给出触发原因和修复动作。

第一类：401 Unauthorized。这是 Key 相关问题的总称。可能原因有三个：Key 没设置、Key 写错、Key 前后有空格。排查时先确认环境变量真的被读到了：

python3 -c "import os; print(repr(os.environ.get('TAOTOKEN_API_KEY')))"

如果打印出None，说明环境变量没生效，检查你是不是在另一个终端窗口设置的。如果打印出带空格的字符串，用.strip()清一下。还有一种情况是 Key 已过期或被删除，去 API Keys 页面重新生成一个：

• API Keys：https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=api-keys&utm_campaign=rewrite

第二类：local proxy failed或类似的连接失败提示。这类报错通常出现在请求根本发不出去的时候，原因可能是 Base URL 拼错、网络不通、或者本地有拦截。先确认 Base URL 是https://taotoken.net/api，注意结尾不要多加/v1之外的路径。然后用curl做一次最原始的探测：

curl -i -X POST "https://taotoken.net/api/v1/chat/completions" \ -H "Content-Type: application/json" \ -H "Authorization: Bearer $TAOTOKEN_API_KEY" \ -d '{"model":"你的ModelID","messages":[{"role":"user","content":"ping"}],"max_tokens":8}'

如果curl能通而 Python 不通，问题在 Python 侧，多半是代理设置或 SSL 证书。如果curl也不通，问题在配置或网络。

第三类：KeyError: 'choices'或reading choices相关。这类报错说明请求发出去了、也收到响应了，但响应体不是预期的对话结构。最常见原因是 Model ID 填错，服务端返回了一个错误对象而不是正常回复。打印完整响应体就能看到真相：

print(json.dumps(result, ensure_ascii=False, indent=2))

看到error字段后，对照错误信息调整 Model ID 即可。记住三件套：Base URL、Key、Model ID，缺一不可，错一不可。

第四类：OAuth相关报错。如果你用的是某些 CLI 工具（比如 Claude Code 这类），它们可能默认走 OAuth 登录流程，而不是 API Key。这时候需要显式配置 Base URL 和 Key，把认证方式从 OAuth 切到 API Key。以 Claude Code 为例，配置里要写清楚三件套：

{ "base_url": "https://taotoken.net/api", "api_key": "sk-你的key", "model": "你的ModelID" }

如果你用的是 Codex 的auth.json，结构类似，把base_url、api_key、model三个字段填对即可。Cline 的 MCP 配置也是同样的三件套逻辑。核心原则：任何工具接入 TaoToken，都是 Base URL + Key + Model ID，没有例外。

把这几类报错对照着排查，基本能覆盖 90% 以上的自检失败场景。剩下的边缘情况，多半是数据库侧的问题，比如账号权限不足、库不存在、端口被防火墙挡了，这些在probe_mysql.py的异常分支里会打印出具体原因。

6. 把版本探测接入你的日常自检流程

到这里，你已经有了两段能跑的脚本：一段探测 MySQL 版本，一段探测 TaoToken 通道。接下来要做的是把它们变成日常习惯，而不是一次性玩具。

最直接的做法是写一个selfcheck.sh，把两个脚本串起来，任何一步失败就退出非零码：

#!/usr/bin/env bash set -e echo "[1/2] probing TaoToken channel..." python3 probe_channel.py echo "[2/2] probing MySQL version..." python3 probe_mysql.py echo "all checks passed"

放进 CI 的 smoke test 阶段，每次部署前跑一次。这样通道挂了或数据库连不上，流水线会直接拦住，不会把问题带到线上。

另一个实用技巧是把版本号写进日志。SELECT VERSION()的结果不只是给人看的，也可以作为元数据记录到每次任务的日志头部。这样当某个 SQL 在某个环境报错时，你能立刻知道那个环境的 MySQL 版本，不用再登机器查。对于多环境团队，这个习惯能省下大量来回确认的时间。

如果你要做更完整的接入，建议把 API 文档过一遍，里面有针对不同语言和工具的配置示例：

• 接入文档：https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite

文档里对 Base URL、Key、Model ID 的说明和本篇一致，遇到不确定的参数可以对照查阅。

最后说一个我踩过的坑：早期我把 Key 直接写在脚本里，结果换环境时忘了改，脚本一直连的是测试 Key，排查了半天才发现。后来统一改成环境变量，再也没出过这个问题。所以无论你多急，都别把 Key 硬编码进代码。环境变量 + 三件套配置，是 TaoToken 接入最省心的姿势。