EXPLAIN显示key为NULL的根源是JOIN或WHERE中字段collation不匹配,而非索引缺失或SQL错误;MySQL因B+树依赖严格有序比较,遇collation差异(如utf8mb4_unicode_ci与utf8mb4_0900_as_cs)会弃用索引,强制全表扫描或隐式转换。

EXPLAIN 显示 key 为 NULL 就是字符集或 collation 不匹配的铁证
不是索引没建,也不是 SQL 写错,而是 MySQL 在 JOIN 或 WHERE 比较前发现两边字段的 collation_name 不一致,主动弃用索引。B+ 树依赖严格有序比较,而不同 collation 下,相同字符串可能被判定为不等(比如 utf8mb4_unicode_ci 和 utf8mb4_0900_as_cs 对德语变音符号或大小写的处理逻辑不同),数据库无法保证结果正确性,只能退化为全表扫描或临时转换字段值。
必须查三层 collation,不能只看字符集
字段、连接层、SQL 字面量三者任意一对不匹配都会触发隐式转换:
-
SHOW FULL COLUMNS FROM table1 LIKE 'join_col'—— 看字段级真实Collation -
SELECT @@collation_connection, @@character_set_client—— 连接层决定'abc'这类字面量按什么规则解释 -
SHOW CREATE TABLE table1—— 确认表默认CHARACTER SET和列级是否混用COLLATE
常见坑:字段是 utf8mb4_unicode_ci,但 @@collation_connection 是 latin1_swedish_ci 或 utf8mb4_0900_as_cs,哪怕字符集都是 utf8mb4,只要 COLLATE 不同,就触发转换。
ALTER TABLE 改字段必须同时指定 CHARACTER SET 和 COLLATE
只改 CHARACTER SET 不改 COLLATE,大概率白忙——MySQL 比对的是排序规则,不是字符集本身:
安装、修复、更新或打包一个基于 Python 和 PyMySQL 实现的 Windows `mysql` 命令。适用于用户希望在 PowerShell/CMD 中输入 `mysql` 时重定向到 Python 实现、需要交互式输入 MySQL 连接信息、需要同步到当前用户本地 bin 目录,或需要将该能力封装成可公开复用的 Codex skill。
- 错误写法:
ALTER TABLE users CONVERT TO CHARACTER SET utf8mb4—— 会保留原COLLATE,可能仍是utf8mb4_unicode_ci - 错误写法:
ALTER TABLE users MODIFY username VARCHAR(50) COLLATE utf8mb4_0900_as_cs—— 漏了CHARACTER SET - 正确写法:
ALTER TABLE users MODIFY username VARCHAR(50) CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_as_cs
改完立刻 SHOW CREATE TABLE 验证字段定义里是否同时出现 CHARACTER SET utf8mb4 和 COLLATE utf8mb4_0900_as_cs,再跑 EXPLAIN 看 key 是否出现索引名。
连接层不统一,改表也没用
应用连上数据库后,@@collation_connection 决定了 SQL 中字符串字面量的默认排序规则。ORM 或驱动没显式指定时,MySQL fallback 到服务端默认值,极易错配:
- Java JDBC 连接串加:
?useUnicode=true&characterEncoding=utf8mb4&collationConnection=utf8mb4_0900_as_cs - PHP mysqli 连接后立刻执行:
mysqli_set_charset($conn, 'utf8mb4'),并确认SET NAMES utf8mb4 COLLATE utf8mb4_0900_as_cs - 验证是否生效:
SELECT CHARSET('测试'), COLLATION('测试')—— 返回值应与字段Collation完全一致
漏掉 collation= 这部分,前面所有表和字段改得再整齐,查询时仍可能触发转换。真正要命的点在于:collation 必须完全一致,差一个字符都不行。

















