// MySQL 錯誤參考
MySQL 錯誤 1071:指定的鍵太長
索引寬度超過 InnoDB 允許的上限(3072 位元組,較舊的資料列格式為 767 位元組),通常出現在很長的 utf8mb4 VARCHAR 上。
- 錯誤號碼
1071- 名稱
ER_TOO_LONG_KEY- SQLSTATE
42000- 類別
- 鍵與約束
它的意義
最大鍵長是以位元組計算,而不是字元。使用 utf8mb4 每個字元可能佔用 4 個位元組,因此 VARCHAR(255) 每個欄位最多需要 1020 位元組。而 InnoDB 搭配 DYNAMIC 或 COMPRESSED 資料列格式允許每個索引 3072 位元組;較舊的 COMPACT 和 REDUNDANT 格式才允許到 767,這也是 VARCHAR(255) 在 utf8mb4 失敗。
常見原因
- 在長
utf8mb4VARCHAR,尤其是在 MySQL 5.6 或舊的資料列格式上。 - 複合索引的欄位總和超過限制。
如何修正
-
使用
DYNAMIC資料列格式(MySQL 5.7 起的預設)。ALTER TABLE users ROW_FORMAT = DYNAMIC;
-
對欄位的前綴建立索引,適用於非唯一索引。
CREATE INDEX idx_users_bio ON users (bio(191));
-
不需要長值時可縮短欄位,例如
VARCHAR(191)對於索引的電子郵件位於utf8mb4在 767 位元組限制內。
相關錯誤
更多索引鍵與條件約束錯誤
1062索引鍵的重複項目1452外鍵失敗:無法新增子資料列1451外鍵失敗:無法刪除父資料列1216無法新增或更新子資料列1217無法刪除或更新父資料列1215無法新增外鍵條件約束3780外鍵欄位不相容1822外部索引鍵條件約束缺少索引
程式碼和訊息文字來自 MySQL 8.4 錯誤訊息參考。瀏覽完整的 MySQL 錯誤清單 或 搜尋每個資料庫錯誤.
// 錯誤更少,修復更快
在 SQLly 裡操作 MySQL
適用於 macOS、Windows 和 Linux 的原生 SQL 客戶端,具備結構描述感知的 IntelliSense、高風險陳述式防護與清楚的錯誤訊息,適用於 MySQL 和你使用的其他資料庫。