解决MySQL设置utf8mb4后仍然无法保存emoji表情

问题描述

之前开发时需要在数据库保存emoji表情符号，在数据库将表的字符集设置为utf8mb4，仍然无法保存表情，提示下面的报错 :java.sql.SQLException: Incorrect string value: '\xF0\x9F\x92\x94'。

最后发现是数据库连接的问题，本想在数据库链接参数中添加characterEncoding=utf8mb4，但是并不生效。最后是在每次执行保存emoji表情的语句之前，执行SET NAMES utf8mb4。后面又发现可以在建立数据库链接的初始化语句中直接添加SET NAMES utf8mb4。

MySQL 数据库的默认字符集utf8,只能存储3个字节的数据,标准的emoji表情是4个字节,所以要使用utf8mb4兼容四个字节

解决方案

这里整理了一下，设置utf8mb4之后仍然无法保存emoji表情的解决步骤。

1. MySQL版本不低于5.5.3。

2. MySQL驱动，5.1.34可用,最低不能低于5.1.13

3. 检查数据库表以及表字段的字符集是否为utf8mb4。如果不是需要更改为utf8mb4：

修改库的字符集

alter database 库名 character set utf8mb4 collate utf8mb4_general_ci

修改表的字符集
alter table 表名 character set utf8mb4 collate utf8mb4_general_ci

这里要注意，表中的字段编码是否更改。可用show create table 表名 查看建表语句中每个字段的编码是否为utf8mb4。

这里需要索引失效的问题，不同表关联字段的编码如果不一致，会导致索引失效。

4. 在数据库链接初始化语句中添加执行SET NAMES utf8mb4，这里以Druid连接池为例，

xml配置方式，需要定义连接池bean的属性中添加connectionInitSqls。例如

<bean id="dataSource" class="com.alibaba.druid.pool.DruidDataSource" init-method="init" destroy-method="close">
        <property name="url" value="${mysql.url}"/>
        <property name="username" value="${mysql.username}"/>
        <property name="password" value="${mysql.password}"/>
 
                     
        <!-- 这里省略其他相关配置，加入下面的属性配置即可 -->       
        <!-- 这里省略其他相关配置，加入下面的属性配置即可 -->
        <!-- 这里省略其他相关配置，加入下面的属性配置即可 -->
        <property name="connectionInitSqls" value="SET NAMES utf8mb4"/>
    </bean>

如果是springboot项目可以直接在配置中添加：

spring.datasource.druid.connection-init-sqls=set names utf8mb4;