让MySQL支持emoji图标存储

2020-12-14 02:40:14 编辑 1 阅读量:447

在使用django存储表单时，曾经出现过`ERROR (1366, "Incorrect string value: '\\xF0\\x9F\\x9A\\xAB\\x0D\\x0A...' for column 'body' at row 1")`的错误，经过认真排查发现是mysql使用的utf8格式不支持4个字节的utf8字符（MYSQL 5.5 之前， UTF8 编码只支持**1-3个字节**，只支持BMP这部分的unicode编码区，而 emoji 图标恰好是4个字节的编码进行存储。从MYSQL5.5开始，可支持4个字节UTF编码 utf8mb4 ，一个字符最多能有4字节，所以能支持更多的字符集。所以要解决问题，必需把数据库表字符编码全部改成 utf8mb4 。），按照网上一些教程修改后依旧报错，后面发现是在使用django连接mysql时，还需要设置`’OPTIONS’: {’charset’: 'utf8mb4'}`。具体解决步骤如下：
### 登陆mysql查看并修改字符类型
```mysql
mysql> SHOW VARIABLES WHERE Variable_name LIKE 'character\_set\_%' OR Variable_name LIKE 'collation%';  # 查看字符类型
mysql> ALTER DATABASE database_name CHARACTER SET = utf8mb4 COLLATE utf8mb4_unicode_ci; # 修改需要使用的数据库
mysql> ALTER TABLE table_name CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; # 修改表
mysql> ALTER TABLE table_name CHANGE column_name column_name VARCHAR(191) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci NOT NULL;  # 修改具体字段，结合具体的字段属性，也可以用下面的 ALTER TABLE 这里是表名字 modify 字段名字 VARCHAR(50) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT '';
```
### 修改mysql配置
```
$ sudo vim /etc/my.cnf # 添加下面的内容，然后重启mysql
[client]
default-character-set = utf8mb4

[mysql]
default-character-set = utf8mb4

[mysqld]
character-set-client-handshake = FALSE
character-set-server = utf8mb4
collation-server = utf8mb4_unicode_ci
$ sudo service mysql restart  # linux系统下重启mysql
```
### 修改django连接mysql属性
```
DATABASES = {
    ’default’: {
        ’ENGINE’: ’django.db.backends.mysql’,
        ’NAME’: ’example’,
        ’USER’: ’example’,
        ’PASSWORD’: ’example’,
        ’HOST’: ’’,
        ’PORT’: ’’,
        ’OPTIONS’: {’charset’: ’utf8mb4’},  # 新增该字段
    }
}
```
### 附录
#### 1.创建时指定utf8mb4
```mysql
mysql> CREATE DATABASE `irenshi` DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; # 创建数据库时指定
mysql> CREATE TABLE `tab_staff` (
  `id` int(11) DEFAULT NULL,
  `staffName` varchar(100) DEFAULT NULL
) CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;  # 创建表时指定
mysql> 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; # 创建列时指定
```
#### 2.查看编码集
```mysql
mysql> SHOW VARIABLES WHERE Variable_name LIKE 'character_set_%' OR Variable_name LIKE 'collation%';
# 或者
mysql> use database_name;   # 选定数据库
mysql> show full columns from table_name; # 查看表
```
---
参考：
- [1][Using Emojis in Django Model Fields](http://blog.manbolo.com/2014/03/31/using-emojis-in-django-model-fields)
- [2][让MySQL支持emoji图标存储](https://github.com/jaywcjlove/mysql-tutorial/blob/master/chapter17/17.1.md)
- [3][让MySql支持Emoji表情(MySQL中4字节utf8字符保存方法)](https://my.oschina.net/u/178116/blog/548803)
- [4][创建支持emoji表情的MySQL数据库（utf8mb4）](http://www.xiaotanzhu.com/2016/08/14/create-mysql-database-with-utf8mb4.html)

让MySQL支持emoji图标存储

附件: