// SQLite 錯誤參考

SQLITE_CONSTRAINT_NOTNULL:NOT NULL 約束失敗

INSERT 或 UPDATE 試圖把 NULL 存入 NOT NULL 欄位,通常是因為漏列該欄位而又沒有預設值。訊息會指出是哪個欄位。

結果代碼
SQLITE_CONSTRAINT_NOTNULL
名稱
1299
類別
擴展結果程式碼
錯誤訊息
NOT NULL constraint failed: users.name

它的意義

SQLITE_CONSTRAINT_NOTNULL (1299) 表示一個 NOT NULL 欄位會收到 NULL。這發生在你明確傳入 NULL 的時候,也發生在 INSERT 遺漏某個 NOT NULL 欄位,且沒有 DEFAULT,因為缺少的那一欄會拿到 NULL。

常見原因

  • 這 INSERT 欄位清單缺少一個沒有預設值的必填欄位。
  • 應用程式為缺少的值傳入了 NULL 或 None。
  • 新增一個 NOT NULL 在重建資料表時新增欄位,而不必為現有資料列填值。

如何修正

  1. 提供欄位的值,或給它一個預設值。

    INSERT INTO users (email, name) VALUES ('[email protected]', 'Ada');
  2. 檢查哪些欄位是必填的。

    PRAGMA table_info(users);  -- notnull = 1, dflt_value
  3. 要為現有資料表新增必填欄位,請給它一個預設值,讓既有資料列都有值可填。

    ALTER TABLE users ADD COLUMN status TEXT NOT NULL DEFAULT 'active';

安全地重現問題

CREATE TABLE users (email TEXT, name TEXT NOT NULL);
INSERT INTO users (email) VALUES ('a@x');  -- Runtime error: NOT NULL constraint failed: users.name (19)

相關錯誤

更多延伸結果碼錯誤

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

// 錯誤更少,修復更快

在 SQLly 裡操作 SQLite

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