轉
問題描述:
如果UTF8字符集且是Java服務器的話齿税,當存儲含有emoji表情時挖函,會拋出類似如下異常:
java.sql.SQLException: Incorrectstringvalue:'\xF0\x9F\x92\x94'forcolumn'name'at row1at 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編碼有可能是兩個考婴、三個宰衙、四個字節(jié)幅狮,其中Emoji表情是4個字節(jié)能岩,而Mysql的utf8編碼最多3個字節(jié)寞宫,所以導致了數據插不進去。
升級前需要考慮的問題:
如果你的項目要進行移動產品的用戶文本的存儲捧灰,將你的DB字符集從UTF8/GBK等傳統(tǒng)字符集升級到utf8mb4將是勢在必行淆九。你可以通過應用層面轉換emoji等特殊字符,以達到原DB的兼容毛俏,我認為可行炭庙,但是你可能走了彎路。
utf8mb4作為utf8的super set煌寇,完全向下兼容焕蹄,所以不用擔心字符的兼容性問題。切換中需要顧慮的主要影響是mysql需要重新啟動(雖然mysql官方文檔說可以動態(tài)修改配置阀溶,但是經過數次測試腻脏,還是需要重啟才可生效)鸦泳,對于業(yè)務可用率的影響是需要考慮的大問題,這里就暫時不展開討論了永品。
升級步驟:
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涉瘾。關于這些字符集配置是干什么用的,有什么區(qū)別吭净,請參考:深入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字符集甚负,多么痛的領悟!审残!