mysql/Java服务端对emoji的支持

深藏阁楼爱情的钟 2022-04-12 11:40 188阅读 0赞

引自：http://blog.csdn.net/junsure2012/article/details/42171035

## 前言： ##

最近开发的iOS项目因为需要用户文本的存储，自然就遇到了emoji等表情符号如何被mysql DB支持的问题。困扰了数日，在就要绝望放弃的边缘，终于完成了转换和迁移。在此特别分析和整理，方便更多人。

## 问题描述： ##

如果UTF8字符集且是Java服务器的话，当存储含有emoji表情时，会抛出类似如下异常：

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)

这就是字符集不支持的异常。因为UTF-8编码有可能是两个、三个、四个字节，其中Emoji表情是4个字节，而Mysql的utf8编码最多3个字节，所以导致了数据插不进去。

##  ##

## 升级前需要考虑的问题： ##

如果你的项目要进行移动产品的用户文本的存储，将你的DB字符集从UTF8/GBK等传统字符集升级到utf8mb4将是势在必行。你可以通过应用层面转换emoji等特殊字符，以达到原DB的兼容，我认为可行，但是你可能走了弯路。

utf8mb4作为utf8的super set，完全向下兼容，所以不用担心字符的兼容性问题。切换中需要顾虑的主要影响是mysql需要重新启动（虽然mysql官方文档说可以动态修改配置，但是经过数次测试，还是需要重启才可生效），对于业务可用率的影响是需要考虑的大问题，这里就暂时不展开讨论了。

## 升级步骤： ##

1.utf8mb4的最低mysql版本支持版本为5.5.3+，若不是，请升级到较新版本。

mysql版本查看命令请看：[查看mysql版本的四种方法][mysql]；mysql安装步骤请看：[Linux中升级Mysql到Mysql最新版本的方法][Linux_Mysql_Mysql]  
2.修改database、table和column字符集。参考以下语句：  
ALTER DATABASE database\_name CHARACTER SET = utf8mb4 COLLATE = utf8mb4\_unicode\_ci;  
ALTER TABLE table\_name CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4\_unicode\_ci;  
ALTER TABLE table\_name CHANGE column\_name VARCHAR(191) CHARACTER SET utf8mb4 COLLATE utf8mb4\_unicode\_ci;  
3.修改mysql配置文件my.cnf（windows为my.ini）

my.cnf一般在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  
init\_connect='SET NAMES utf8mb4'

4.重启 MySQL Server、检查字符集

1.）重启命令参考：/etc/init.d/mysql restart

2.）输入命令：mysql，进入mysql命令行（如果提示没权限，可以尝试输入mysql -uroot -p你的密码）

3.）在mysql命令行中输入：SHOW VARIABLES WHERE Variable\_name LIKE 'character\_set\_%' OR Variable\_name LIKE 'collation%';

检查是否如下：

特别说明下：collation\_connection/collation\_database/collation\_server如果是utf8mb4\_general\_ci，没有关系。但必须保证character\_set\_client/character\_set\_connection/character\_set\_database/character\_set\_results/character\_set\_server为utf8mb4。关于这些字符集配置是干什么用的，有什么区别，请参考：[深入Mysql字符集设置][Mysql]

5.如果你用的是java服务器，升级或确保你的mysql connector版本高于5.1.13，否则仍然无法使用utf8mb4  
这是mysql官方[release note][]，大家可以查看说明，并下载最新的mysql connector for java的jar包。  
这里为大家提供一个：[mysql-connector-java-5.1.31-bin.jar][]  
同时记得修改pom配置哦~

6.检查你服务端的db配置文件：

jdbc.driverClassName=com.mysql.jdbc.Driver  
jdbc.url=jdbc:mysql://localhost:3306/database?useUnicode=true&characterEncoding=utf8&autoReconnect=true&rewriteBatchedStatements=TRUE  
jdbc.username=root  
jdbc.password=password

特别说明其中的jdbc.url配置：如果你已经升级好了mysql-connector，其中的characterEncoding=utf8可以被自动被识别为utf8mb4（当然也兼容原来的utf8），而autoReconnect配置我强烈建议配上，我之前就是忽略了这个属性，导致因为缓存缘故，没有读取到DB最新配置，导致一直无法使用utf8mb4字符集，多么痛的领悟！！

感谢这位仁兄的分享，顺利的帮助我解决了问题，但是我直接拿maven下载的驱动5.1.31还是不好用，后来修改成5.1.13后就没有问题了。

[mysql]: http://www.cnblogs.com/end/archive/2011/10/18/2216461.html
[Linux_Mysql_Mysql]: http://www.111cn.net/sys/linux/61026.htm
[Mysql]: http://www.laruence.com/2008/01/05/12.html
[release note]: http://dev.mysql.com/doc/relnotes/connector-j/en/news-5-1-13.html
[mysql-connector-java-5.1.31-bin.jar]: http://www.ilikewhite.com/wp-content/uploads/2014/07/mysql-connector-java-5.1.31-bin.zip