// SQLite 錯誤參考

SQLITE_CONSTRAINT_CHECK:CHECK 約束失敗

有一列未通過資料表上的 CHECK 運算式。訊息會指出約束名稱,約束沒有名稱時則顯示運算式本身。

結果代碼
SQLITE_CONSTRAINT_CHECK
名稱
275
類別
擴展結果程式碼
錯誤訊息
CHECK constraint failed: price_positive

它的意義

SQLITE_CONSTRAINT_CHECK (275) 表示某個值讓 CHECK 運算式為 false。請替你的約束命名(CONSTRAINT price_positive CHECK (price > 0)),所以訊息會告訴你是哪一條規則失敗;對未命名的條件約束,新版 SQLite 會改為印出運算式。

結果為 NULL 的 CHECK 會通過,所以 CHECK (price > 0) 不會拒絕 NULL 價格。

常見原因

  • 超出允許範圍或清單的值。
  • 不符合模式的文字,例如 CHECK (email LIKE '%@%').
  • 用 CHECK 模擬列舉或布林,卻收到意外的值。

如何修正

  1. 檢視約束定義。

    SELECT sql FROM sqlite_schema WHERE name = 'products';
  2. 修正該值,或者如果資料正確而規則錯誤,就修改規則。SQLite 無法直接修改 CHECK;需要使用新定義重建資料表。

  3. 為條件約束命名,讓失敗訊息更容易解讀。

    CREATE TABLE products (
        id    INTEGER PRIMARY KEY,
        price REAL NOT NULL CONSTRAINT price_positive CHECK (price > 0)
    );

相關錯誤

更多延伸結果碼錯誤

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

// 錯誤更少,修復更快

在 SQLly 裡操作 SQLite

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