mysql/Java服務端對emoji的支援，mysqlemoji

mysql/Java服務端對emoji的支援，mysqlemoji
前言：

最近開發的iOS項目因為需要使用者文本的儲存，自然就遇到了emoji等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安裝步驟請看：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%';

檢查是否如下：

+--------------------------+--------------------+
| 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              |
| collation_connection    | utf8mb4_unicode_ci |
| collation_database      | utf8mb4_unicode_ci |
| collation_server        | utf8mb4_unicode_ci |
+--------------------------+--------------------+
rows in set (0.00 sec)

特別說明下：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字元集設定

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字元集，多麼痛的領悟！！

著作權聲明：本文為博主原創文章，未經博主允許不得轉載。