問題分析

在微信開發過程中，總是會遇到帶有emoji表情暱稱的微信使用者無法自動登入的問題。
後臺程式碼丟擲類似下面的異常資訊。

java.sql.SQLException: Incorrect string value: '\xF0\x9F\x92\x94' for colum n '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)
 

原來emoji表情是佔4個位元組的，但是在MySQL中UTF-8字元只是佔3個位元組，這就導致MySQL資料庫無法儲存emoji表情了。

解決方法

既然知道了原因，那麼解決方法也就產生了。
只要讓MySQL的字元佔4個位元組就成了。恰好MySQL5.5.3 以後的版本都有 utf8mb4 這種字符集，它每個字元佔4個位元組，滿足儲存emoji表情的需要。
現在目標是將MySQL資料庫有原來的字符集修改為 utf8mb4。

1. 修改資料庫、表、列的字符集

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(50) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
 

2. 修改MySQL配置檔案 my.cnf（windows下是 my.ini）

[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'    
 

注意： 如果後臺程式碼使用了 mysql-connector-x.x.x.jar ，那麼mysql-connector的版本必須高於 5.1.13 ，否則不支援 utf8mb4。

參考這篇部落格 mysql儲存emoji表情（微信開發使用者暱稱..）