1. 问题重现
mysql> create database school;
mysql> use school;
mysql> create table student(name varchar(10));
mysql> insert into student values("Clarke");
mysql> select * from student;
+--------+
| name |
+--------+
| Clarke |
+--------+
mysql> insert into student values("唐三");
# 插入中文失败
ERROR 1366 (HY000): Incorrect string value: '\xE5\x94\x90\xE4\xB8\x89' for column 'name' at row 1
2. 分析和解决
2.1 数据库编码设置
2.1.1 查看 MySQL 程序编码设置
mysql> show variables like 'char%';
+--------------------------+----------------------------+
| Variable_name | Value |
+--------------------------+----------------------------+
| character_set_client | latin1 |
| character_set_connection | latin1 |
| character_set_database | latin1 |
| character_set_filesystem | binary |
| character_set_results | latin1 |
| character_set_server | latin1 |
| character_set_system | utf8 |
| character_sets_dir | /usr/share/mysql/charsets/ |
+--------------------------+----------------------------+
可以看到,设置里有很多的编码设置是 latin1,这是 MySQL 默认的编码,这个编码是无法正确显示中文的,如果你的设置也是这样,这就是导致中文编码问题的可能原因。
关于这些设置的含义:
2.1.2 修改编码设置
编码设置中我们需要关注的是下面 5 个字符编码设置:
# 服务端相关
character_set_server
character_set_database #当前选中数据库的编码,切换数据库时改变,这个设置不需要手动修改
# 客户端相关
character_set_client
character_set_connection
character_set_results
修改编码设置的方式有三种。
方式1: session 范围修改
mysql> set character_set_server=utf8mb4
建议使用 utf8mb4 编码而不是 utf8,因为 MySQL 的 utf8 编码有点小问题,可以自行百度 MySQL 中 utf8 和
utf8mb4 的区别
这种修改方式是 session 范围的,也就是当前的 MySQL 连接结束后,设置就失效了。
其他几个编码设置也一样修改。
方式2: global 范围修改
mysql> set global character_set_server=utf8mb4
global 范围下的修改,重新连接依然有效,直到 MySQL 服务端重启。
方式3: 修改配置文件
想要编码设置在 MySQL 服务端重启后依然生效,可以修改配置文件。
不同平台的配置文件位置不一样,可以通过下面命令查看:
➜ ~ mysql --verbose --help | grep my.cnf
/etc/my.cnf /etc/mysql/my.cnf /usr/local/mysql/etc/my.cnf ~/.my.cnf
更多说明: MySQL 官方文档:4.2.2.2 Using Option Files[2]
除了~/.my.cnf文件是用户级别的外,其他几个位置都是系统级别的,如果该位置没有my.cnf文件,就新建一个文本文件,命名为 my.cnf。
windows 系统下,这个文件叫 my.ini。
在 my.cnf 文件中添加以下内容:
[mysqld]
character_set_server=utf8mb4
collation_server=utf8mb4_unicode_ci
[client]
default_character-set=utf8mb4
更多信息参考: A.11 MySQL 8.0 FAQ: MySQL Chinese, Japanese, and Korean
Character Sets[3]
配置项说明:
•character-set-server 设置影响 character_set_server 的值,character_set_database 的值在未选中当前数据库的情况下,默认跟随 character_set_server 的值。
•default-character-set 影响 character_set_client, character_set_connection, character_set_results 三者的值。
在 MySQL 连接终端中执行 SET NAMES 也是影响的 character_set_client,
character_set_connection, character_set_results 三者的值
•collation_server 影响 orderby 的排序结果,建议设置 character-set-server 的同时也要设置
关于 character_set_server 和 collation_server: MySQL doc -
sysvar_character_set_server[4]
修改配置文件后重启 MySQL,再查看下编码设置,
mysql> show variables like 'char%';
+--------------------------+----------------------------+
| Variable_name | Value |
+--------------------------+----------------------------+
| character_set_client | utf8mb4 |
| character_set_connection | utf8mb4 |
| character_set_database | utf8mb4 |
| character_set_filesystem | binary |
| character_set_results | utf8mb4 |
| character_set_server | utf8mb4 |
| character_set_system | utf8 |
| character_sets_dir | /usr/share/mysql/charsets/ |
+--------------------------+----------------------------+
可以看到已经生效了,5 个相关设置已经修改为 utf8mb4。
三种修改方式,优先选择修改配置文件,其次的选择或者想要灵活设置的话,可以在终端会话中设置。
2.2 已创建的数据库的编码
如果上面的配置已经修改完成,可能仍然有中文编码问题,因为对于已经创建完成的数据库和表,它的编码在创建时已经确定了,前面的配置项(character_set_server)已经不能影响了,需要逐个修改相应的数据库,表,列。
2.2.1 具体数据库的编码
查看完整的数据库创建语句:
mysql> show create database school;
+----------+-------------------------------------------------------------------+
| Database | Create Database |
+----------+-------------------------------------------------------------------+
| school | CREATE DATABASE `school` /*!40100 DEFAULT CHARACTER SET latin1 */ |
+----------+-------------------------------------------------------------------+
可以看到数据库 school 的默认编码仍然是 latin1,改起:
mysql> alter database school character set 'utf8mb4';
mysql> show create database school;
+----------+--------------------------------------------------------------------+
| Database | Create Database |
+----------+--------------------------------------------------------------------+
| school | CREATE DATABASE `school` /*!40100 DEFAULT CHARACTER SET utf8mb4 */ |
+----------+--------------------------------------------------------------------+
2.2.2 表的编码
在前一节,数据库 school 的默认编码已经修改为 utf8mb4,接下来看数据表的默认编码:
mysql> show create table student;
+---------+---------------------------------------------------------------------------------------------------+
| Table | Create Table |
+---------+---------------------------------------------------------------------------------------------------+
| student | CREATE TABLE `student` (
`name` varchar(10) DEFAULT NULL
) ENGINE=InnoDB DEFAULT CHARSET=latin1 |
+---------+---------------------------------------------------------------------------------------------------+
看到数据表 student 的默认编码仍然是 latin1,再改起:
mysql> alter table student character set 'utf8mb4';
Query OK, 0 rows affected (0.03 sec)
Records: 0 Duplicates: 0 Warnings: 0
mysql> show create table student;
+---------+-------------------------------------------------------------------------------------------------------------------------+
| Table | Create Table |
+---------+-------------------------------------------------------------------------------------------------------------------------+
| student | CREATE TABLE `student` (
`name` varchar(10) CHARACTER SET latin1 DEFAULT NULL
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 |
+---------+-------------------------------------------------------------------------------------------------------------------------+
2.2.3 列的编码
在上一节可以看到,数据表 student 的默认编码已经修改为 utf8mb4,但是列 name 的编码还是 latin1,改起!
mysql> alter table `student` change `name` `name` text character set 'utf8mb4';
Query OK, 1 row affected (0.04 sec)
Records: 1 Duplicates: 0 Warnings: 0
mysql> show create table student;
+---------+--------------------------------------------------------------------------------+
| Table | Create Table |
+---------+--------------------------------------------------------------------------------+
| student | CREATE TABLE `student` (
`name` text
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 |
+---------+--------------------------------------------------------------------------------+
到这里,对于已经存在的数据库,修改完成,再插入中文试试:
mysql> insert into student value("昊天");
Query OK, 1 row affected (0.00 sec)
mysql> select * from student;
+--------+
| name |
+--------+
| Clarke |
| 昊天 |
+--------+
2 rows in set (0.00 sec)
成功!到此,中文编码的问题就解决了。
2.3 防御性编码
为了防止意外的情况发生,我们可以采取更健壮的防御性编码的方式,哪怕数据库服务端的编码设置不正确,我们仍然可以插入中文数据。
具体就是在创建数据表的时候指定默认编码:
mysql> show variables like 'char%';
+--------------------------+----------------------------+
| Variable_name | Value |
+--------------------------+----------------------------+
| character_set_client | latin1 |
| character_set_connection | latin1 |
| character_set_database | latin1 |
| character_set_filesystem | binary |
| character_set_results | latin1 |
| character_set_server | latin1 |
| character_set_system | utf8 |
| character_sets_dir | /usr/share/mysql/charsets/ |
+--------------------------+----------------------------+
8 rows in set (0.00 sec)
# 指定存储引擎,编码,排序规则
mysql> create table course(name varchar(32)) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
Query OK, 0 rows affected (0.03 sec)
mysql> insert into course value('高数');
Query OK, 1 row affected (0.01 sec)
mysql> select * from course;
+--------+
| name |
+--------+
| 高数 |
+--------+
1 row in set (0.00 sec)
或者直接在创建数据库的时候就指定编码:
mysql> create database school DEFAULT CHARACTER SET utf8mb4;
3. 总结
解决 MySQL 中文编码问题的步骤:
1.查看数据库编码设置
2.修改编码设置,在终端中修改设置项,或者修改配置文件 my.cnf 以永久生效
3.对于之前创建的数据库,修改数据库,数据表,数据列的默认编码
最佳实践:防御性编码,在数据库创建语句中指定默认编码。