MySQL插入emoji表情失敗問題的解決方法

前言

之前一直認(rèn)為UTF-8是萬能的字符集問題解決方案，直到最近遇到這個(gè)問題。最近在做新浪微博的爬蟲， 在存庫的時(shí)候發(fā)現(xiàn)只要保持emoji表情，就回拋出以下異常：

Incorrect string value: '\xF0\x90\x8D\x83\xF0\x90...'

眾所周知UTF-8是3個(gè)字節(jié), 其中已經(jīng)包括我們?nèi)粘Ｄ芤娺^的絕大多數(shù)字體. 但3個(gè)字節(jié)遠(yuǎn)遠(yuǎn)不夠容納所有的文字, 所以便有了utf8mb4, utf8mb4是utf8的超集, 占4個(gè)字節(jié), 向下兼容utf8. 我們?nèi)粘Ｓ玫膃moji表情就是4個(gè)字節(jié)了.

所以在此我們像utf8的數(shù)據(jù)表插入數(shù)據(jù)就會(huì)報(bào)出Incorrect string value這個(gè)錯(cuò)誤.

Google一下很容易就找到了解決方案, 具體解決辦法是如下：

一、修改數(shù)據(jù)表的字符集為utf8mb4

這點(diǎn)很簡單, 修改語句網(wǎng)上找一大堆, 不過建議重新建表, 使用 mysqldump -uusername -ppassword database_name table_name > table.sql 備份相應(yīng)數(shù)據(jù)表, 并修改其中的建表語句的字符集為 utf8mb4 即可, 然后 mysql -uusername -ppassword database_name table.sql 重新導(dǎo)入sql即可完成修改字符集操作.

二、MySQL數(shù)據(jù)庫版本要5.5.3及以上

網(wǎng)絡(luò)上所有的文章都說明要MySQL 5.5.3以上的版本才支持utf8mb4, 不過我使用的數(shù)據(jù)庫版本為5.5.18, 最終仍能解決問題, 所以同學(xué)們不要急著找運(yùn)維哥哥升級數(shù)據(jù)庫先, 先試試能不能自己解決問題.

三、修改數(shù)據(jù)庫配置文件/etc/my.cnf并重啟mysql服務(wù)

主要是修改數(shù)據(jù)庫的默認(rèn)字符集, 以及連接, 查詢的字符集, [Mysql支持emoji 表情符號 升級編碼為UTF8MB4][1] 這篇文章有詳細(xì)的設(shè)置方法, [深入Mysql字符集設(shè)置][2] 這篇文章有其中設(shè)置的各個(gè)字符集的作用, 大家可以科普下.

四、升級MySQL Connector到5.1.21及以上

以上所有的操作, 最關(guān)鍵的是步驟3, 修改數(shù)據(jù)庫的配置文件, 其中大概修改了

[client]
# 客戶端來源數(shù)據(jù)的默認(rèn)字符集
default-character-set = utf8mb4
[mysqld]
# 服務(wù)端默認(rèn)字符集
character-set-server=utf8mb4
# 連接層默認(rèn)字符集
collation-server=utf8mb4_unicode_ci
[mysql]
# 數(shù)據(jù)庫默認(rèn)字符集
default-character-set = utf8mb4

這些配置指定了數(shù)據(jù)從客戶端到服務(wù)端所經(jīng)過的一條條管道使用的字符集, 其中每一個(gè)管道出現(xiàn)問題都可能會(huì)導(dǎo)致插入失敗或者亂碼.

但很多時(shí)候, 線上的數(shù)據(jù)庫是不能隨便修改數(shù)據(jù)庫文件的, 所以我們的運(yùn)維同學(xué)很果斷的回絕了我修改數(shù)據(jù)庫配置文件的請求(T_T)

所以就只能用代碼解決了, 一開始是準(zhǔn)備從JDBC連接時(shí)候就指定使用的字符集處下手.

jdbc:mysql://localhost:3306/ding?characterEncoding=UTF-8

主要把UTF-8修改為utf8mb4對于的Java Style Charset字符串應(yīng)該就能解決問題吧?

不過很遺憾的是, Java JDBC并不存在utf8mb4對于的字符集. 使用UTF-8的時(shí)候可以兼容urf8mb4并自動(dòng)轉(zhuǎn)換字符集.

For example, to use 4-byte UTF-8 character sets with Connector/J, configure the MySQL server with character_set_server=utf8mb4, and leave characterEncoding out of the Connector/J connection string. Connector/J will then autodetect the UTF-8 setting. – [MySQL:Using Character Sets and Unicode][3]

后來科普了一下, 在每一次查詢請求的時(shí)候, 可以顯式的指定使用的字符集, 使用 set names utf8mb4 可以指定本次鏈接的字符集為utf8mb4, 但這個(gè)設(shè)置在每次連接被釋放后都會(huì)失效.

目前的解決辦法是, 在需要插入utf8mb4的時(shí)候, 顯示地調(diào)用執(zhí)行set names utf8mb4, 如:

jdbcTemplate.execute("set names utf8mb4");
jdbcTempalte.execute("...");

需要注意的是, 我們在使用一下ORM框架的時(shí)候, 因?yàn)樾阅軆?yōu)化原因, 框架會(huì)延遲提交, 除非事務(wù)結(jié)束或者用戶主動(dòng)調(diào)用強(qiáng)制提交, 負(fù)責(zé)執(zhí)行的set names utf8mb4仍然不會(huì)生效.

在這里我使用的是myBatis, 以MessageDao為例

// MessageDao
public interface MessageDao {
 @Update("set names utf8mb4")
 public void setCharsetToUtf8mb4();
 @Insert("insert into tb_message ......")
 public void insert(Message msg);
}
// test code
SqlSession sqlSession = sqlSessioFactory.openSession();
messageDao = sqlSession.getMapper(MessageDao.class);
messageDao.setCharsetToUtf8mb4();
// 強(qiáng)制提交
sqlSession.commit();
messageDao.insert(message);

至此, 問題便解決了..

哎, 如果世事能那么順利就好了, 在項(xiàng)目中, mybatis是實(shí)例是交由Spring去管理的, 也就是說我拿不到sqlSession, 也就是強(qiáng)制提交不了. 并且因?yàn)镾pring事務(wù)框架的限制, 他并不允許用戶顯式調(diào)用強(qiáng)制提交. 目前還在糾結(jié)這個(gè)問題.

有兩個(gè)解決思路:

• 使用AOP, 在可能插入4字節(jié)UTF8字符的時(shí)候, 前置方法執(zhí)行set names utf8mb4, 但該方案還不能確定AOP的方法會(huì)被Spring進(jìn)行事務(wù)管理么, 并且在前置方法中,拿到的鏈接是否和接下來拿到的連接對象是同一個(gè)session.
• 研究Spring JDBC的創(chuàng)建方法, 寫一個(gè)hook在每次創(chuàng)建新的數(shù)據(jù)庫連接的時(shí)候, 都執(zhí)行一次set names utf8mb4, 這樣就保證每一次拿到的鏈接都是設(shè)置過字符集的.
  

總結(jié)

以上就是這篇文章的全部內(nèi)容了，待有時(shí)間再實(shí)驗(yàn)一下以上兩種方案。希望本文的內(nèi)容對大家的學(xué)習(xí)或者工作能帶來一定的幫助，如果有疑問大家可以留言交流，謝謝大家對腳本之家的支持。