MySQL 導入 SQL 文件報語法錯誤：版本不兼容與編碼問題排查

常見報錯原因

1. MySQL 版本差異：導出環境 8.0，導入環境 5.7。8.0 新增 `VISIBLE/INVISIBLE` 索引屬性、窗口函數、CTE 語法，5.7 不支持。
   解決：導出時指定兼容模式 `mysqldump --compatible=mysql57` 或手動修改 SQL。
2. SQL_MODE 差異：`ONLY_FULL_GROUP_BY`、`NO_AUTO_VALUE_ON_ZERO` 等導致行為不同。導入前設置 `SET SESSION sql_mode = '';` 或匹配模式。
3. 字符集編碼：文件為 UTF-8，導入目標庫為 latin1/gbk。導致中文亂碼或語法錯 (如含多字節字符的標識符)。
   解決：`mysql --default-character-set=utf8mb4 -u root -p db < file.sql`
4. 分隔符衝突：文件包含存儲過程/觸發器，未修改 `DELIMITER` 導致 `;` 過早截斷。需在文件首部添加 `DELIMITER //` 並在結構體結尾用 `//`。< /li>

排查步驟

1. 查看具體報錯行號：`ERROR 1064 (42000) at line 123: ...`
2. 提取該行上下文 10 行，對照 MySQL 手冊語法。
3. 小文件直接編輯修正；大文件用 `sed`/`awk` 批量替換不兼容語法。

最佳實踐

• 開發、測試、生產環境 **統一 MySQL 大版本**。
• 遷移優先使用 `mysqldump --routines --triggers --single-transaction` 保證一致性。
• 重要遷移先在測試庫演練，驗證數據完整性。< /li>