// 錯誤參考
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,並為有風險的語句提供防護欄。