django，mysql存储emoji表情，utf8mb4

今天在做后台的时候发现一个错误：

Incorrect string value: '\\xF0\\x9F\\x90\\xA8' for column 'signature' at row 1

发现是参数里面是一个iOS的表情，也就是系统自带的emoji表情。

后台用的是django 1.6，数据库用的是Mysql 5.5.22，缓存用的是redis。

上网了解了一下emoji表情，原来一般的字符包括中文用utf8的话，mysql是用3个字节去存储的，而emoji表情要用4个字节的utf8，也就是utf8mb4格式。

首先更改mysql的数据编码，修改mysql的配置文件：  /etc/mysql/my.cnf 添加：

[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

然后重启，mysql，查看mysql的编码
SHOW VARIABLES WHERE Variable_name LIKE 'character\_set\_%' OR Variable_name LIKE 'collation%';
+--------------------------+----------------------------+
| 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_unicode_ci         |
| collation_database       | utf8mb4_unicode_ci         |
| collation_server         | utf8mb4_unicode_ci         |
+--------------------------+----------------------------+
OK,mysql改完了，然后创建数据库：

create database xxx CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
创建数据库之后是syncdb，这时 MySQLdb模块 需要1.2.4以上版本，关于MySQLdb模块的安装可以参考这篇文章，最新版是1.2.5
syncdb成功之后，再次尝试插入，还是报错。

查看了一下这部分的源代码，发现django/db/backends/mysql/base.py中的DatabaseWrapper类中有个kwargs的属性，里面有个key叫charset，默认值是utf8，后面做数据库连接的时候，会用django的settings中，database的options去更新这一项。

class DatabaseWrapper(BaseDatabaseWrapper):
 
    def get_connection_params(self):
        kwargs = {
            'conv': django_conversions,
            'charset': 'utf8',
        }

那么我们修改一下django的settings.py，在数据库的配置中加入options项。

DATABASES = {
    'default': {
        #'ENGINE': 'sqlite3', # Add 'postgresql_psycopg2', 'postgresql', 'mysql', 'sqlite3' or 'oracle'.
        'ENGINE': 'django.db.backends.mysql',
        #'NAME': '/opt/media/session.db',                      # Or path to database file if using sqlite3.
        'NAME': DATABASE_NAME,
        'USER': 'root',                      # Not used with sqlite3.
        'PASSWORD': DATABASE_PASSWORD,                  # Not used with sqlite3.
        'HOST': DATABASE_HOST,                      # Set to empty string for localhost. Not used with sqlite3.
        'PORT': DATABASE_PORT,                      # Set to empty string for default. Not used with sqlite3.
        'OPTIONS': {'charset':'utf8mb4'},
    },
}
然后再尝试插入emoji表情，结果正常，取出来结果也正常，ios和android都可以正常使用。

由于实际在阿里云上部署的时候，mysql使用的是docker container，似乎不方便修改container里面的mysql配置文件（进去container，里面没有vi），尝试不改配置文件，只是在创建数据库的时候指定character set 为utf8mb4，collate为 utf8mb4_unicode_ci，发现其实也可以用，那么应该是只需要保证连接mysql的时候是用utf8mb4，并且mysql数据的编码格式是utf8mb4即可。

网上有更完整的关于存储emoji表情到mysql的例子可以参考：http://blog.manbolo.com/2014/03/31/using-emojis-in-django-model-fields