// MySQL 錯誤參考

MySQL 錯誤 1071:指定的鍵太長

索引寬度超過 InnoDB 允許的上限(3072 位元組,較舊的資料列格式為 767 位元組),通常出現在很長的 utf8mb4 VARCHAR 上。

錯誤號碼
1071
名稱
ER_TOO_LONG_KEY
SQLSTATE
42000
類別
鍵與約束
錯誤訊息
Specified key was too long; max key length is %d bytes

它的意義

最大鍵長是以位元組計算,而不是字元。使用 utf8mb4 每個字元可能佔用 4 個位元組,因此 VARCHAR(255) 每個欄位最多需要 1020 位元組。而 InnoDB 搭配 DYNAMIC 或 COMPRESSED 資料列格式允許每個索引 3072 位元組;較舊的 COMPACT 和 REDUNDANT 格式才允許到 767,這也是 VARCHAR(255) 在 utf8mb4 失敗。

常見原因

  • 在長 utf8mb4 VARCHAR,尤其是在 MySQL 5.6 或舊的資料列格式上。
  • 複合索引的欄位總和超過限制。

如何修正

  1. 使用 DYNAMIC 資料列格式(MySQL 5.7 起的預設)。

    ALTER TABLE users ROW_FORMAT = DYNAMIC;
  2. 對欄位的前綴建立索引,適用於非唯一索引。

    CREATE INDEX idx_users_bio ON users (bio(191));
  3. 不需要長值時可縮短欄位,例如 VARCHAR(191) 對於索引的電子郵件位於 utf8mb4 在 767 位元組限制內。

相關錯誤

更多索引鍵與條件約束錯誤

程式碼和訊息文字來自 MySQL 8.4 錯誤訊息參考。瀏覽完整的 MySQL 錯誤清單 或 搜尋每個資料庫錯誤.

// 錯誤更少,修復更快

在 SQLly 裡操作 MySQL

適用於 macOS、Windows 和 Linux 的原生 SQL 客戶端,具備結構描述感知的 IntelliSense、高風險陳述式防護與清楚的錯誤訊息,適用於 MySQL 和你使用的其他資料庫。