为什么MySQL 8.0客户端--default-character-set=utf8mb4参数对连接无效?
问题原因
这是MySQL 8.0客户端与5.6版本服务端的字符集兼容性问题:
- MySQL 8.0版本客户端默认使用
utf8mb4_0900_ai_ci作为utf8mb4字符集的排序规则,该排序规则是8.0版本新增,MySQL 5.6服务端无法识别 - 服务端在握手阶段收到无法识别的字符集/排序规则时,会自动回退到服务端默认的latin1编码,因此你指定的
--default-character-set=utf8mb4参数失效 - 其他字符集(如koi8r)的排序规则没有8.0专属的新版规则,客户端发送的旧版规则可以被5.6服务端正常识别,因此参数生效
客户端侧解决方案
不需要修改服务端配置,可通过以下两种方式解决:
方案1:指定5.6支持的utf8mb4排序规则
所有MySQL官方客户端工具(mysql、mysqldump、mysqlimport等)都支持指定排序规则参数,直接指定5.6可识别的utf8mb4_general_ci即可让参数正常生效:
- mysql连接命令示例:
/usr/bin/mysql -h ${DB_HOST} -u ${DB_USER} -p --default-character-set=utf8mb4 --default-collation=utf8mb4_general_ci
- mysqldump命令示例:
mysqldump -h ${DB_HOST} -u ${DB_USER} -p --default-character-set=utf8mb4 --default-collation=utf8mb4_general_ci 数据库名 > 导出文件.sql
- mysqlimport命令示例:
mysqlimport -h ${DB_HOST} -u ${DB_USER} -p --default-character-set=utf8mb4 --default-collation=utf8mb4_general_ci 数据库名 导入文件.txt
如果希望全局生效,可在当前用户目录下创建.my.cnf配置文件,添加以下内容:
[client] default-character-set = utf8mb4 default-collation = utf8mb4_general_ci
保存后所有客户端工具默认会读取该配置,不需要每次手动加参数。
方案2:连接后自动执行字符集设置
如果不方便指定排序规则,可通过客户端的init-command参数,在连接建立后自动执行SET NAMES utf8mb4,效果和手动执行一致:
- mysql连接命令示例:
/usr/bin/mysql -h ${DB_HOST} -u ${DB_USER} -p --init-command="SET NAMES utf8mb4"
- mysqldump命令示例:
mysqldump -h ${DB_HOST} -u ${DB_USER} -p --init-command="SET NAMES utf8mb4" 数据库名 > 导出文件.sql
内容的提问来源于stack exchange,提问作者Ben Kean
相关产品推荐
相关产品推荐

