MySQL字符串字段索引失效的根源是字段、连接会话与SQL字面量三者COLLATION不一致,导致优化器主动弃用索引;须用SHOW FULL COLUMNS、SELECT @@collation_connection、SHOW CREATE TABLE精准比对,并统一为utf8mb4_0900_as_cs,ALTER TABLE修改时必须同时指定CHARACTER SET和COLLATE。

MySQL 5.7 字符串字段索引失效的根源是 collation 不匹配
索引失效不是因为没建索引,而是 MySQL 优化器发现 WHERE 条件里的字符串字面量和字段的 COLLATION 不兼容,不敢用索引。典型表现是 EXPLAIN 显示 type=ALL 或 key=NULL,哪怕字段明明有索引。
关键要查清三者是否一致:
-
SHOW FULL COLUMNS FROM table_name LIKE 'column_name'—— 看字段实际Collation -
SELECT @@collation_connection—— 看当前连接生效的排序规则 -
SHOW CREATE TABLE table_name—— 看表默认COLLATE是否与字段一致
常见错配:字段是 utf8mb4_unicode_ci,但连接层用的是 utf8mb4_0900_as_cs,或 SQL 中写 'abc' 时被隐式转成另一套规则比对。
修改字段 COLLATION 必须连带指定 CHARACTER SET
只改字符集不改排序规则,或反过来,基本等于白干。MySQL 比较时看的是 COLLATION,不是字符集名字本身。
错误写法(不生效):
ALTER TABLE t MODIFY name VARCHAR(50) CHARACTER SET utf8mb4;
正确写法(必须显式带 COLLATE):
ALTER TABLE t MODIFY name VARCHAR(50) CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_as_cs;
批量改多个字段时分步操作,避免锁表太久:
ALTER TABLE t MODIFY a VARCHAR(64) CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_as_cs, MODIFY b VARCHAR(128) CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_as_cs;
大表务必在低峰期执行;若字段已有索引,MODIFY 会重建索引,耗时明显。
安装、修复、更新或打包一个基于 Python 和 PyMySQL 实现的 Windows `mysql` 命令。适用于用户希望在 PowerShell/CMD 中输入 `mysql` 时重定向到 Python 实现、需要交互式输入 MySQL 连接信息、需要同步到当前用户本地 bin 目录,或需要将该能力封装成可公开复用的 Codex skill。
连接层 collation_connection 必须显式声明
字段层改对了,但应用连进来时 @@collation_connection 还是错的,WHERE 里的字符串字面量仍会被转义,索引照旧失效。
各客户端配置方式:
- JDBC 连接串加:
?useUnicode=true&characterEncoding=utf8mb4&collationConnection=utf8mb4_0900_as_cs - PDO DSN 加:
;charset=utf8mb4;collation=utf8mb4_0900_as_cs - 命令行客户端启动时加:
--default-collation=utf8mb4_0900_as_cs
别依赖服务端默认值——MySQL 5.7 默认连接 collation 往往是 utf8mb4_general_ci,而你字段可能设成了 utf8mb4_bin,一碰就失效。
JSON 字段中字符串值的大小写匹配要小心 ->> 和 COLLATE
直接用 request_param->'$.user_name' 返回的是 JSON 类型,比较时走二进制语义,区分大小写;而 request_param->>'$.user_name' 返回字符串,才能用 COLLATE 控制行为。
例如字段存的是 {"user_name": "ABC"},想用小写 'abc' 匹配:
- 错:
WHERE request_param->'$.user_name' = 'abc'—— 返回 JSON,大小写敏感 - 对:
WHERE request_param->>'$.user_name' = 'abc' COLLATE utf8mb4_general_ci
注意:->> 是 MySQL 5.7.13+ 才支持的语法,低于此版本只能用 JSON_UNQUOTE(JSON_EXTRACT(...)) 替代。
真正难处理的不是怎么改,而是所有环节——字段定义、连接参数、SQL 字面量、甚至 ORM 生成的查询——必须全部对齐同一套 COLLATION。漏掉任意一层,索引就悄悄失效,且不会报错。

















