MySQL Version Tokens 怎样列出服务器当前令牌

要列出 MySQL Version Tokens 当前保存在服务器上的令牌，核心语句只有一条：

-- 读取服务器端当前的 name=value 令牌列表
SELECT version_tokens_show();

返回值通常是以分号分隔的字符串，例如 region=cn;role=read;。它表示服务器令牌集合，不是客户端连接自己的版本号。执行前要确认 version_tokens 插件和对应函数已经安装，并让运维账号拥有 VERSION_TOKEN_ADMIN 权限。

官方文档：https://dev.mysql.com/doc/refman/8.4/en/version-tokens-reference.html

先确认插件和权限边界

Version Tokens 由服务端插件保存令牌，并通过一组可加载函数提供 SQL 接口。先看插件是否处于活动状态，再检查当前账号的授权，比直接反复执行查询更容易定位问题。

-- 确认 Version Tokens 插件是否已激活
SELECT PLUGIN_NAME, PLUGIN_STATUS, PLUGIN_LIBRARY
FROM INFORMATION_SCHEMA.PLUGINS
WHERE PLUGIN_NAME = 'version_tokens';

-- 查看当前账号能否调用管理类函数
SHOW GRANTS;

正常情况下，插件查询应能看到 ACTIVE。如果结果为空，说明当前实例没有加载该插件，不能把空结果误解为“服务器没有令牌”。如果返回权限错误，则应由管理员授予最小必要的 VERSION_TOKEN_ADMIN，而不是给业务账号扩大权限。

用 version_tokens_show() 读取当前令牌

确认前置条件后执行查询即可。该函数无参数，返回一个二进制字符串形式的列表；令牌名和值使用 name=value 表示，不同令牌之间以分号分隔。

-- 读取当前列表；结果只用于观察，不会修改服务器令牌
SELECT version_tokens_show() AS server_tokens;

建议把返回值原样记录在发布或切换记录中，再由应用层按分号拆分。不要在 SQL 中按固定顺序取第一个或第二个字段，因为官方说明明确指出令牌顺序没有业务意义。令牌名和值按二进制字符串比较，大小写差异也可能导致匹配失败。

把读取结果和修改函数分开

读取当前令牌使用 version_tokens_show()；初始化或整体替换使用 version_tokens_set()；局部新增或修改使用 version_tokens_edit()。生产排查时先读后改，尤其不要为了“验证函数可用”直接调用 set。

例如，服务器列表里有 role=read，客户端把会话要求设为 role=write，后续语句会因值不一致而失败；客户端要求的令牌名如果服务器不存在，则属于 token not found。服务器多出客户端没有要求的令牌，并不自动构成不匹配。

生产排查清单与常见误区

• 函数不存在：先检查插件和函数是否安装；只安装函数而未加载插件时，接口不能正常工作。
• 返回空字符串：它可能代表令牌列表确实为空，也可能是初始化尚未执行；应结合插件状态和变更记录判断。
• 权限不足：检查 SHOW GRANTS，优先补充 VERSION_TOKEN_ADMIN，不要用共享超级账号长期查询。
• 结果看起来顺序变化：不要以字符串顺序判断业务状态；应按令牌名和值解析。
• 读取成功但业务仍报错：继续检查客户端的 version_tokens_session，并区分 token not found 与 token mismatch。

常见问题

version_tokens_show() 会修改服务器令牌吗？

不会。它只读取并返回当前服务器列表，修改动作应使用 set、edit 或 delete 类函数。

为什么服务器列表为空但查询没有报错？

Version Tokens 初始化后列表可以为空；空列表不等于插件缺失。请同时检查插件状态和函数是否可调用。

服务器多了一个客户端没有的令牌，会导致匹配失败吗？

不会。匹配重点是客户端声明的令牌名和值；只有客户端要求的令牌不存在或值不同，才会触发对应错误。