// 錯誤參考

MySQL 錯誤碼

大家最常遇到的 MySQL 伺服器與用戶端錯誤,每個都附上 MySQL 錯誤參考中的訊息文字、符號與 SQLSTATE,說明錯誤的意義與修復方法。

解讀 MySQL 錯誤

MySQL 報告錯誤為 ERROR 1062 (23000): Duplicate entry '7' for key 'users.PRIMARY'。數字是 MySQL 錯誤碼,方括號裡的五個字元是 SQLSTATE,其餘是填入佔位符後的訊息。

錯誤碼 1000 到 1999 以及 3000 以上由伺服器發出;2000 到 2999 則由用戶端程式庫發出,通常是因為連線無法建立或已中斷,因此伺服器可能從未收到該陳述式。

執行 SHOW WARNINGS; 在語句之後執行,即可查看警告與注意事項,兩者使用相同的編號。許多資料錯誤(例如 1265 或 1366)在非嚴格 SQL 模式下是警告,在嚴格模式下則是錯誤。

本參考資料中的所有 MySQL 錯誤

79 個代碼,79 個皆有完整說明(附連結)。代碼與訊息來自 MySQL 8.4 錯誤訊息參考.

連線與用戶端

程式碼意義
2002 無法透過 socket 連線 CR_CONNECTION_ERROR 無法透過 socket '%s' (%d) 連線到本機 MySQL 伺服器
2003 無法連線到位於該主機的 MySQL 伺服器 CR_CONN_HOST_ERROR 無法連線到 '%s:%u' (%d) 的 MySQL 伺服器
2005 未知的 MySQL 伺服器主機 CR_UNKNOWN_HOST 未知的 MySQL 伺服器主機 '%s' (%d)
2006 MySQL 伺服器已斷線 CR_SERVER_GONE_ERROR MySQL 伺服器已斷線
2013 查詢期間與 MySQL 伺服器失去連線 CR_SERVER_LOST 查詢期間與 MySQL 伺服器失去連線
2055 在階段中與 MySQL 伺服器失去連線 CR_SERVER_LOST_EXTENDED 在 '%s' 與 MySQL 伺服器失去連線,系統錯誤:%d
2026 SSL 連線錯誤 CR_SSL_CONNECTION_ERROR SSL 連線錯誤:%s
2059 驗證外掛無法載入 CR_AUTH_PLUGIN_CANNOT_LOAD 驗證外掛 '%s' 無法載入:%s
2061 驗證外掛回報錯誤 CR_AUTH_PLUGIN_ERR 驗證外掛 '%s' 回報錯誤:%s
1251 客戶端不支援驗證通訊協定 ER_NOT_SUPPORTED_AUTH_MODE 客戶端不支援伺服器要求的驗證通訊協定;請考慮升級 MySQL 客戶端
3159 禁止不安全的傳輸 ER_SECURE_TRANSPORT_REQUIRED 在 --require_secure_transport=ON 時,禁止使用不安全傳輸的連線。
1158 讀取通訊封包時發生錯誤 ER_NET_READ_ERROR 讀取通訊封包時出錯
1159 讀取通訊封包時逾時 ER_NET_READ_INTERRUPTED 讀取通訊封包時逾時
4031 因閒置被伺服器中斷連線 ER_CLIENT_INTERACTION_TIMEOUT 客戶端因閒置而被伺服器斷線。請參閱 wait_timeout 與 interactive_timeout 以設定此行為。

存取與權限

程式碼意義
1045 使用者存取被拒 ER_ACCESS_DENIED_ERROR 拒絕使用者 '%s'@'%s' 存取(使用密碼:%s)
1044 使用者存取資料庫被拒 ER_DBACCESS_DENIED_ERROR 使用者 '%s'@'%s' 存取資料庫 '%s' 被拒
1130 主機不允許連線 ER_HOST_NOT_PRIVILEGED 主機 '%s' 不允許連線至此 MySQL 伺服器
1698 拒絕使用者存取(未使用密碼) ER_ACCESS_DENIED_NO_PASSWORD_ERROR 拒絕使用者 '%s'@'%s' 存取
1142 使用者被拒絕對資料表執行命令 ER_TABLEACCESS_DENIED_ERROR 使用者 '%s'@'%s' 對資料表 '%s' 的 %s 指令遭拒
1143 使用者被拒絕對欄位執行命令 ER_COLUMNACCESS_DENIED_ERROR 使用者 '%s'@'%s' 對資料表 '%s' 中欄位 '%s' 的 %s 指令遭拒
1227 存取被拒;你需要權限 ER_SPECIFIC_ACCESS_DENIED_ERROR 存取被拒;你需要 (至少一個) %s 權限來執行此操作
1396 CREATE USER 操作失敗 ER_CANNOT_USER 對 %s 的 %s 操作失敗
1419 啟用二進位記錄需要 SUPER 權限 ER_BINLOG_CREATE_ROUTINE_NEED_SUPER 你沒有 SUPER 權限且二進位記錄已啟用(你*可能*想使用較不安全的 log_bin_trust_function_creators 變數)
1449 定義者使用者不存在 ER_NO_SUCH_USER 指定為定義者的使用者 ('%s'@'%s') 不存在

語法與陳述式

程式碼意義
1064 你的 SQL 語法有錯誤 ER_PARSE_ERROR 第 %d 行的 '%s' 附近發生 %s
1149 SQL 語法錯誤 ER_SYNTAX_ERROR 你的 SQL 語法有錯誤;請查閱與你的 MySQL 伺服器版本相對應的手冊,以取得正確的語法
1052 欄位不明確 ER_NON_UNIQ_ERROR %s 中的欄位 '%s' 不明確
1055 運算式不在 GROUP BY 中 ER_WRONG_FIELD_WITH_GROUP '%s' 不在 GROUP BY 中
1093 無法指定要更新的目標資料表 ER_UPDATE_TABLE_USED 不能在 FROM 子句中指定資料表 '%s' 進行更新
1136 欄位數量與值數量不符 ER_WRONG_VALUE_COUNT_ON_ROW 第 %ld 列的欄位數量與值數量不符
1242 子查詢傳回超過 1 列 ER_SUBQUERY_NO_1_ROW 子查詢傳回超過 1 列
1248 每個派生表都必須有自己的別名 ER_DERIVED_MUST_HAVE_ALIAS 每個派生表都必須有自己的別名
1318 引數數量不正確 ER_SP_WRONG_NO_OF_ARGS %s %s 的引數數量不正確;預期 %u,實得 %u

資料庫、資料表與欄位

程式碼意義
1049 未知資料庫 ER_BAD_DB_ERROR 未知資料庫 '%s'
1046 未選取資料庫 ER_NO_DB_ERROR 未選取資料庫
1054 欄位清單中有未知欄位 ER_BAD_FIELD_ERROR 未知的欄位 '%s',位於 '%s'
1146 資料表不存在 ER_NO_SUCH_TABLE 資料表 '%s.%s' 不存在
1050 資料表已存在 ER_TABLE_EXISTS_ERROR 資料表 '%s' 已存在
1051 未知資料表 ER_BAD_TABLE_ERROR 未知資料表 '%s'
1060 重複的欄位名稱 ER_DUP_FIELDNAME 重複的欄位名稱 '%s'
1091 無法 DROP;請檢查該欄位/鍵是否存在 ER_CANT_DROP_FIELD_OR_KEY 無法 DROP '%s';請檢查該欄位/鍵是否存在
1305 函式或預存程序不存在 ER_SP_DOES_NOT_EXIST %s %s 不存在
1442 觸發器無法更新自己的資料表 ER_CANT_UPDATE_USED_TABLE_IN_SF_OR_TRG 無法在預存函式/觸發器中更新資料表 '%s',因為叫用此預存函式/觸發器的陳述式已在使用它。

鍵與約束

程式碼意義
1062 索引鍵的重複項目 ER_DUP_ENTRY 鍵 %d 的重複項目 '%s'
1061 重複的鍵名稱 ER_DUP_KEYNAME 重複的鍵名稱 '%s'
1452 外鍵失敗:無法新增子資料列 ER_NO_REFERENCED_ROW_2 無法新增或更新子資料列:外鍵條件約束失敗%s
1451 外鍵失敗:無法刪除父資料列 ER_ROW_IS_REFERENCED_2 無法刪除或更新父資料列:外鍵條件約束失敗%s
1216 無法新增或更新子資料列 ER_NO_REFERENCED_ROW 無法新增或更新子資料列:外鍵條件約束失敗
1217 無法刪除或更新父資料列 ER_ROW_IS_REFERENCED 無法刪除或更新父資料列:外鍵條件約束失敗
1215 無法新增外鍵條件約束 ER_CANNOT_ADD_FOREIGN 無法新增外鍵條件約束
3780 外鍵欄位不相容 ER_FK_INCOMPATIBLE_COLUMNS 外鍵條件約束 '%s' 中的參照欄位 '%s' 與被參照欄位 '%s' 不相容。
1822 外部索引鍵條件約束缺少索引 ER_FK_NO_INDEX_PARENT 新增外鍵約束失敗。約束 '%s' 在被參照的資料表 '%s' 中缺少索引
1824 無法開啟被參照的資料表 ER_FK_CANNOT_OPEN_PARENT 無法開啟被參照的資料表 '%s'
1048 欄位不可為 NULL ER_BAD_NULL_ERROR 欄位 '%s' 不可為 NULL
3819 違反 CHECK 約束 ER_CHECK_CONSTRAINT_VIOLATED 違反 CHECK 約束 '%s'。
1071 指定的索引鍵太長 ER_TOO_LONG_KEY 指定的索引鍵太長;索引鍵長度上限為 %d 位元組
1075 只能有一個自動編號欄位,且必須是鍵 ER_WRONG_AUTO_KEY 資料表定義錯誤;只能有一個自動編號欄位,且必須定義為索引鍵
1701 無法截斷含外鍵的資料表 ER_TRUNCATE_ILLEGAL_FK 無法截斷被外鍵條件約束參照的資料表(%s)
1586 索引鍵的重複項目(含鍵名) ER_DUP_ENTRY_WITH_KEY_NAME 鍵 '%s' 的重複項目 '%s'
1826 外鍵條件約束名稱重複 ER_FK_DUP_NAME 外鍵條件約束名稱 '%s' 重複

資料值

程式碼意義
1364 欄位沒有預設值 ER_NO_DEFAULT_FOR_FIELD 欄位 '%s' 沒有預設值
1366 欄位值錯誤 ER_TRUNCATED_WRONG_VALUE_FOR_FIELD 不正確的 %s 值:'%s',欄位 '%s',第 %ld 列
1406 欄位資料過長 ER_DATA_TOO_LONG 欄位 '%s' 的資料過長,位於第 %ld 列
1292 錯誤的值已被截斷 ER_TRUNCATED_WRONG_VALUE 錯誤的 %s 值已被截斷:'%s'
1264 欄位值超出範圍 ER_WARN_DATA_OUT_OF_RANGE 第 %ld 列的欄位 '%s' 值超出範圍
1265 欄位資料被截斷 WARN_DATA_TRUNCATED 欄位 '%s' 的資料被截斷,位於第 %ld 列
1067 無效的預設值 ER_INVALID_DEFAULT '%s' 的預設值無效

交易與鎖定

程式碼意義
1205 鎖定等待逾時 ER_LOCK_WAIT_TIMEOUT 鎖定等待逾時;請嘗試重新啟動交易
1213 嘗試取得鎖時發現死結 ER_LOCK_DEADLOCK 嘗試取得鎖定時發現死結;請嘗試重新啟動交易
3572 使用 NOWAIT 時無法取得鎖定 ER_LOCK_NOWAIT 因為無法立即取得鎖定且已設定 NOWAIT,陳述式已中止。
1206 鎖定數量超過鎖定資料表的大小 ER_LOCK_TABLE_FULL 鎖定總數超過鎖定資料表的大小
1792 在唯讀交易中進行寫入 ER_CANT_EXECUTE_IN_READ_ONLY_TRANSACTION 無法在唯讀交易中執行陳述式。
3024 已超過陳述式執行時間上限 ER_QUERY_TIMEOUT 查詢執行中斷,已超過陳述式的最大執行時間

伺服器限制與設定

程式碼意義
1040 連線過多 ER_CON_COUNT_ERROR 連線過多
1203 使用者的連線數已超過 max_user_connections ER_TOO_MANY_USER_CONNECTIONS 使用者 %s 已經有超過 'max_user_connections' 的有效連線
1153 收到的封包大於 max_allowed_packet ER_NET_PACKET_TOO_LARGE 收到的封包大小超過 'max_allowed_packet' 位元組
1175 安全更新模式已阻擋這個陳述式 ER_UPDATE_WITHOUT_KEY_IN_SAFE_MODE 你正在使用安全更新模式,卻嘗試在 WHERE 沒有用到 KEY 欄位的情況下更新資料表。%s
1290 伺服器選項不允許這個陳述式 ER_OPTION_PREVENTS_STATEMENT MySQL 伺服器以 %s 選項執行,因此無法執行此陳述式
1114 資料表已滿 ER_RECORD_FILE_FULL 資料表 '%s' 已滿
// 一個客戶端,所有引擎

更快速駕馭 MySQL 的方式

SQLly 是適用於 macOS、Windows 和 Linux 的原生 SQL 用戶端,具備結構描述感知的 IntelliSense,並為有風險的語句提供防護欄。