创建支持emoji表情的MySQL数据库（utf8mb4）

发表于 分类于 阅读次数：
创建支持emoji表情的MySQL数据库（utf8mb4）

本文只介绍在创建全新数据库的情况下，如何支持emoji表情等字符。如果需要对现有的数据库修改以支持emoji表情，请参考：How to support full Unicode in MySQL databases

UTF-8编码有可能是两个、三个、四个字节。Emoji表情是4个字节，而MySQL的utf8编码最多3个字节，当使用iPhone等插入表情的时候，会抛出如下错误：

1
2
3
4
5
6
7
8
9
java.sql.SQLException: Incorrect string value: '\xF0\x9F\x92\x94' for column 'name' at row 1
    at com.mysql.jdbc.SQLError.createSQLException(SQLError.java:1073)
    at com.mysql.jdbc.MysqlIO.checkErrorPacket(MysqlIO.java:3593)
    at com.mysql.jdbc.MysqlIO.checkErrorPacket(MysqlIO.java:3525)
    at com.mysql.jdbc.MysqlIO.sendCommand(MysqlIO.java:1986)
    at com.mysql.jdbc.MysqlIO.sqlQueryDirect(MysqlIO.java:2140)
    at com.mysql.jdbc.ConnectionImpl.execSQL(ConnectionImpl.java:2620)
    at com.mysql.jdbc.StatementImpl.executeUpdate(StatementImpl.java:1662)
    at com.mysql.jdbc.StatementImpl.executeUpdate(StatementImpl.java:1581)

解决方案就是：**将MySQL的编码从utf8转换成utf8mb4**。

MySQL服务器配置

修改MySQL配置文件/etc/mysql/my.cnf：

1
2
3
4
[mysqld]
character-set-server=utf8mb4
[mysql]
default-character-set=utf8mb4

这样，在创建数据库或数据库表的时候，如果不指定编码格式，则默认使用utf8mb4。

创建库的时候指定

如果已经配置了服务器的默认编码集，则创建数据库的时候不需要指定CHARACTER和COLLATE。如果无法修改服务器默认设置，则可以使用该方法创建数据库。

1
CREATE DATABASE `irenshi` DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci

可以使用以下SQL查看字符集是否正确：

1
SHOW CREATE DATABASE `irenshi`;

输出如下即可：

1
2
3
4
5
6
7
mysql> SHOW CREATE DATABASE `irenshi`;
+----------+---------------------------------------------------------------------+
| Database | Create Database                                                     |
+----------+---------------------------------------------------------------------+
| irenshi  | CREATE DATABASE `irenshi` /*!40100 DEFAULT CHARACTER SET utf8mb4 */ |
+----------+---------------------------------------------------------------------+
1 row in set (0.00 sec)

创建数据库之后，该数据库中所有表的列的默认字符集都为utf8mb4。

创建表的时候指定

如果无法设置数据库的字符集或者只想指定特定表使用utf8mb4，可以在创建表的时候设置：

1
2
3
4
CREATE TABLE `tab_staff` (
  `id` int(11) DEFAULT NULL,
  `staffName` varchar(100) DEFAULT NULL
) CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;

创建列的时候指定

如果无法设置数据库表的字符集或者只想设置某些字段为utf8mb4，可以在创建表的时候指定列的编码集：

1
2
3
4
5
CREATE TABLE `tab_staff` (
  `id` int(11) DEFAULT NULL,
  `staffName` varchar(100) CHARACTER SET utf8mb4 DEFAULT NULL,
  `idCardNo` varchar(18) DEFAULT NULL
) CHARACTER SET utf8 collate utf8_general_ci;

使用Docker时

如果你使用MySQL的官方Docker启动并创建数据库，官方文档也给出了启动命令：

1
docker run --name some-mysql -e MYSQL_ROOT_PASSWORD=my-secret-pw -d mysql:tag --character-set-server=utf8mb4 --collation-server=utf8mb4_unicode_ci

检查MySQL是否启用了utf8mb4

1
SHOW VARIABLES WHERE Variable_name LIKE 'character_set_%' OR Variable_name LIKE 'collation%';

输出如下说明utf8mb4已经生效：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
+--------------------------+----------------------------+
| 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/ |
| collation_connection     | utf8mb4_general_ci         |
| collation_database       | utf8mb4_general_ci         |
| collation_server         | utf8mb4_general_ci         |
+--------------------------+----------------------------+


转载请注明出处：创建支持emoji表情的MySQL数据库（utf8mb4）
原文地址：https://www.xiaotanzhu.com/%E6%95%B0%E6%8D%AE%E5%BA%93/2016-08-14-create-mysql-database-with-utf8mb4.html