萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 資料庫 >> MySQL 教學

MySQL 字符集不匹配導致備份恢復報錯:latin1/utf8 混用排查與修復全記錄

故障現場

舊庫默認 latin1,新備份為 utf8,恢復時語法錯誤:

ERROR 1064 (42000) at line 292: You have an error in your SQL syntax...
near '[caption id="attachment_271" align="aligncenter" width="300"]'

實際是字符集解碼錯誤導致 SQL 文本變形,非真正語法錯誤。


核心修復:恢復時指定正確字符集

# 關鍵參數:--default-character-set=latin1
/usr/local/mysql/bin/mysql -uroot -p'admin' --default-character-set=latin1 t4x < /tmp/backup.sql

告訴 MySQL:「這個 SQL 文件是按 latin1 編碼的」,避免按當前連接字符集(utf8)誤解析。


字符集系統變量全景圖

變量含義典型值
character_set_client客戶端發送數據編碼utf8 / latin1
character_set_connection連接層轉碼目標編碼utf8 / latin1
character_set_database當前庫默認編碼utf8 / latin1
character_set_results結果集返回編碼utf8 / latin1
character_set_server服務器默認編碼latin1 (舊版默認)
character_set_system系統標識符編碼(固定 utf8)utf8

三層配置生效優先級

  1. 配置文件 /etc/my.cnf:
    [client]
    default-character-set=latin1
    
    [mysqld]
    character-set-server=latin1
  2. 會話級動態設置:
    SET NAMES latin1;  -- 等同於同時設置 client/connection/results
  3. 連接參數:JDBC characterEncoding、PDO charset 等。

實戰排查步驟

  1. SHOW VARIABLES LIKE 'character_set_%'; 記錄當前值。
  2. 檢查備份文件頭部:head -50 backup.sql 看 SET NAMES、CREATE DATABASE ... CHARACTER SET。
  3. 根據備份文件實際編碼,恢復時加 --default-character-set=xxx。
  4. 若已導入亂碼:ALTER TABLE ... CONVERT TO CHARACTER SET utf8mb4 重建。

永久修正建議

  • 統一全鏈路 utf8mb4(參考上篇文章)。
  • 備份腳本強制加參數:mysqldump --default-character-set=utf8mb4 --set-charset。
  • 避免 SET NAMES utf8 混用 latin1 表。
copyright © 萬盛學電腦網 all rights reserved