必须同时确认三层真实值:字段定义的COLLATION_NAME、连接层@@collation_connection、字面量实际collation(如SELECT COLLATION('test')),任意一对不完全相同即可能触发Error 1271或索引失效。

直接看字段的 COLLATION_NAME,别猜、别看库默认值,它和报错没半毛钱关系。
查哪几层的 collation 才算准
MySQL 报错如 Error 1271: Illegal mix of collations 或 EXPLAIN 显示 key: NULL,本质是“比较时规则对不上”。必须同时确认三层真实值:
-
SHOW FULL COLUMNS FROM table1 LIKE 'col_name'—— 看字段定义里写的Collation列,这是最硬的依据 -
SELECT @@collation_connection—— 连接层决定'abc'这类字面量按什么规则解释 -
SELECT COLLATION('test')—— 验证当前会话下字符串字面量实际生效的 collation
只要任意一对不完全相同(比如 utf8mb4_unicode_ci vs utf8mb4_0900_as_cs),就可能触发报错或索引失效。注意:字符集(CHARACTER SET)相同 ≠ collation 可比。
UNION 报错时怎么快速定位冲突列
UNION 报错通常只提示“operation 'UNION'”,但不会说哪一列出问题。用这个方法缩小范围:
- 把 UNION 拆成两个独立 SELECT,分别加
COLLATION(col)查每列的实际排序规则 - 重点比对同位置列(第1列对第1列、第2列对第2列),不是同名字段
- 如果某列一边是
utf8mb4_general_ci,另一边是utf8mb4_0900_ai_ci,这就是罪魁祸首
别依赖 SHOW CREATE TABLE 里表级 DEFAULT COLLATE —— 它不覆盖已定义字段的 collation,字段级定义才起作用。
安装、修复、更新或打包一个基于 Python 和 PyMySQL 实现的 Windows `mysql` 命令。适用于用户希望在 PowerShell/CMD 中输入 `mysql` 时重定向到 Python 实现、需要交互式输入 MySQL 连接信息、需要同步到当前用户本地 bin 目录,或需要将该能力封装成可公开复用的 Codex skill。
ALTER TABLE 改 collation 的坑点
改字段 collation 不是加个 COLLATE 就完事,常见翻车操作:
- 只写
ALTER TABLE t MODIFY col VARCHAR(50) COLLATE utf8mb4_0900_as_cs—— 漏了CHARACTER SET,MySQL 忽略该语句 - 只写
ALTER TABLE t CONVERT TO CHARACTER SET utf8mb4—— 保留原 collation,大概率还是utf8mb4_general_ci - 正确写法:
ALTER TABLE t MODIFY col VARCHAR(50) CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_as_cs
改完立刻执行 SHOW FULL COLUMNS FROM t LIKE 'col' 验证,别信“应该改好了”。大表操作会重建索引并锁表,低峰期再动。
连接层 collation 不对齐,改表也白搭
字段全统一成 utf8mb4_0900_as_cs,但应用连上来时 @@collation_connection 是 utf8mb4_unicode_ci?那 WHERE 条件里的字符串字面量仍会触发隐式转换,索引照废、UNION 照报错。
- JDBC 连接串必须显式加:
?collationConnection=utf8mb4_0900_as_cs - PHP mysqli 连接后立即执行:
mysqli_set_charset($conn, 'utf8mb4')+SET NAMES utf8mb4 COLLATE utf8mb4_0900_as_cs - 验证是否生效:
SELECT @@collation_connection返回值必须和字段COLLATION_NAME完全一致
最容易被忽略的是这一层 —— 表结构改得再干净,连接层没对齐,问题就在那儿等着你。

















