開發與維護 MySQL 時,錯誤代碼是診斷問題的第一線索。本文整理官方常見錯誤代碼(1005-1235),按類別分組並附上中文說明、典型成因與建議處理方式,方便快速排查。
資料庫/資料表操作類
| 代碼 | 訊息 | 常見原因 | 建議處理 |
| 1005 | Can't create table | 外鍵定義錯誤、磁碟空間不足、權限問題 | 檢查外鍵語法、清理空間、確認目錄權限 |
| 1006 | Can't create database | 權限不足、路徑不存在 | 以具備 CREATE DATABASE 權限的用戶執行 |
| 1007 | Database exists | 重複建立同名資料庫 | 先 DROP DATABASE 或改用 CREATE DATABASE IF NOT EXISTS |
| 1008 | Database doesn't exist | 刪除/使用不存在的資料庫 | 確認名稱拼寫、大小寫敏感度 |
| 1050 | Table already exists | 重複建表 | 使用 CREATE TABLE IF NOT EXISTS |
| 1051 | Unknown table | 查詢/刪除不存在的表 | 檢查表名、Schema 名稱 |
| 1114 | Table is full | MyISAM 達 4GB/2GB 限制、InnoDB 表空間耗盡 | 轉 InnoDB、擴充表空間、歸檔舊資料 |
| 1146 | Table doesn't exist | 同 1051 | 同 1051 |
連線與權限類
| 代碼 | 訊息 | 常見原因 | 建議處理 |
| 1040 | Too many connections | 達 max_connections 上限 | 調大參數、檢查連線洩漏、啟用連線池 |
| 1042 | Bad host | 主機名解析失敗 | 檢查 /etc/hosts、DNS、skip-name-resolve |
| 1044 | Access denied for user | 用戶無資料庫權限 | GRANT 對應權限、FLUSH PRIVILEGES |
| 1045 | Access denied (password) | 密碼錯誤、Plugin 不匹配 | 重設密碼、確認 authentication_plugin |
| 1130 | Host not allowed to connect | 用戶 Host 欄位不匹配 | 新增 user@'%' 或具體 IP |
| 1227 | Access denied; you need SUPER | 操作需 SUPER 權限 | 以 root 或具 SUPER 權限用戶執行 |
資料完整性與 SQL 語法類
| 代碼 | 訊息 | 常見原因 | 建議處理 |
| 1022 | Duplicate key | 唯一索引/主鍵衝突 | 檢查業務邏輯、用 INSERT IGNORE / ON DUPLICATE KEY UPDATE |
| 1048 | Column cannot be null | NOT NULL 欄位未給值 | 補齊預設值或應用層驗證 |
| 1062 | Duplicate entry | 同 1022 | 同 1022 |
| 1065 | Empty query | 執行空 SQL | 檢查應用程式動態 SQL 組裝邏輯 |
| 1149 | Syntax error | SQL 語法錯誤 | 對照 MySQL 手冊、留意保留字跳脫 |
| 1169 | Duplicate entry on UPDATE | 更新導致唯一鍵衝突 | 同 1022 |
資源與系統類
| 代碼 | 訊息 | 常見原因 | 建議處理 |
| 1021 | Disk full | 磁碟空間不足 | 清理日誌、擴充磁碟、遷移資料目錄 |
| 1037 | Out of memory | 記憶體耗盡 | 重啟服務、調小 innodb_buffer_pool_size、檢查記憶體洩漏 |
| 1038 | Out of sort memory | sort_buffer_size 過小 | 調大參數、優化 ORDER BY/GROUP BY |
| 1158-1161 | Network read/write error/timeout | 網路不穩、防火牆、MTU | 檢查網路、調大 net_read_timeout/net_write_timeout |
| 1205 | Lock wait timeout | 行鎖等待超過 innodb_lock_wait_timeout | 縮短事務、優化索引、調大參數 |
| 1216 | FK constraint fails (child) | 子表插入無對應父鍵 | 先插入父表、檢查外鍵定義 |
| 1217 | FK constraint fails (parent) | 父表刪除/更新有子表引用 | 先處理子表、或設 ON DELETE CASCADE |
版本與功能相容類
| 代碼 | 訊息 | 說明 |
| 1235 | This version of MySQL doesn't support... | 功能需較新版本(如 CTE、Window Function 需 8.0+) |
排查黃金三步驟
- 看代碼:`SHOW ERRORS` 或應用日誌中的 SQLSTATE/Errno
- 查手冊:官方 MySQL Error Reference 最權威
- 對場景:結合當前操作(DDL/DML/連線/備份)縮小範圍
提示:生產環境建議啟用 log_error_verbosity=3 記錄完整錯誤堆疊,配合監控告警(如 Prometheus + Grafana)實現異常秒級發現。