// SQLite 錯誤參考

SQLITE_CONSTRAINT:約束失敗

某個 INSERT 或 UPDATE 違反了約束:UNIQUE、PRIMARY KEY、NOT NULL、CHECK 或 FOREIGN KEY。訊息和延伸錯誤碼會指出是哪一個。

結果代碼
SQLITE_CONSTRAINT
名稱
19
類別
主要結果代碼
錯誤訊息
constraint failed

它的意義

SQLITE_CONSTRAINT (19) 表示某個語句會違反資料表的某條規則,所以 SQLite 中止了它。通用文字是 constraint failed,但訊息通常會點名規則和欄位,例如 UNIQUE constraint failed: users.email,而延伸錯誤碼會告訴你錯誤的種類: SQLITE_CONSTRAINT_UNIQUE, _PRIMARYKEY, _NOTNULL, _CHECK, _FOREIGNKEY, _DATATYPE (STRICT 資料表)或 _TRIGGER (觸發程序中的 RAISE() 在觸發器中)。

預設情況下,失敗的陳述式會被復原(衝突模式 ABORT),但同一交易中較早的陳述式會保留。

常見原因

  • 主鍵或唯一欄位的重複值。
  • 一個 NULL 出現在 NOT NULL 欄位,通常是因為 INSERT 漏了該欄位,而它又沒有預設值。
  • 值不符合 CHECK 運算式。
  • 找不到父資料列的子資料列,附帶 PRAGMA foreign_keys = ON.
  • 型別錯誤的值出現在 STRICT 表中。

如何修正

  1. 閱讀訊息或延伸錯誤碼,確認是哪個條件約束失敗,再看資料表定義。

    SELECT sql FROM sqlite_schema WHERE name = 'users';
  2. 對於希望合併或跳過的重複項,使用 upsert 或 conflict 子句。

    INSERT INTO users (email, name) VALUES ('[email protected]', 'Ada')
    ON CONFLICT (email) DO UPDATE SET name = excluded.name;
  3. 至於其他條件約束,請修正你要寫入的資料:補上缺少的值、先插入父資料列,或改正未通過檢查的值。

相關錯誤

更多主要結果碼錯誤

程式碼和訊息文字來自 SQLite 結果代碼與錯誤碼文件。瀏覽完整的 SQLite 錯誤清單 或 搜尋每個資料庫錯誤.

// 錯誤更少,修復更快

在 SQLly 裡操作 SQLite

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