// SQLite 錯誤參考

SQLITE_ERROR:SQL 邏輯錯誤

SQLite 的通用錯誤碼:語法錯誤、缺少資料表或欄位,或 SQL 的其他問題。真正的原因在錯誤訊息中,而不是錯誤碼中。

結果代碼
SQLITE_ERROR
名稱
1
類別
主要結果代碼
錯誤訊息
SQL logic error

它的意義

SQLITE_ERROR (1) 是 SQLite 在沒有更具體代碼適用時所使用的錯誤碼。幾乎所有 SQL 本身的錯誤都落在這裡:拼字錯誤、不存在的資料表或欄位、已存在的資料表、值的數量不對。通用文字是 SQL logic error;訊息來自 sqlite3_errmsg() 說明實際出了什麼問題,例如 no such table: users, no such column: emial, near "FORM": syntax error 或 table users already exists.

因為同一個錯誤碼涵蓋了許多不同的問題,所以務必記錄並閱讀訊息。

常見原因

  • 語法錯誤: near "...": syntax error 會指出解析失敗的語彙基元。
  • no such table:資料表名稱拼錯了,或是它位在你沒有指明名稱的附加資料庫裡,不然就是程式開啟了另一個(通常是全新且空的)資料庫檔案,和你以為的不一樣。
  • no such column:拼錯的欄位名稱,或是用雙引號寫、被 SQLite 當成欄位名稱的字串常值。
  • table ... already exists 來自 CREATE TABLE 沒有 IF NOT EXISTS.
  • 使用你的 SQLite 版本太舊而不支援的語法或函式,例如 RETURNING (3.35) 或視窗函式 (3.25)。

如何修正

  1. 閱讀完整訊息,修正它指出的問題。檢查你實際連線的結構描述(schema):

    SELECT name, type FROM sqlite_schema ORDER BY name;
    PRAGMA table_info(users);
  2. 如果缺少某個資料表,請檢查開啟的是哪個檔案。相對路徑會相對於程序的工作目錄開啟檔案,而開啟不存在的路徑會建立一個新的空資料庫。

    PRAGMA database_list;
  3. 字串常值使用單引號,識別碼則只用雙引號。

    SELECT * FROM users WHERE status = 'active';
  4. 當較新的語法失敗時,檢查程式庫的版本。

    SELECT sqlite_version();

安全地重現問題

SELECT * FROM no_such_table;   -- Parse error: no such table: no_such_table

相關錯誤

更多主要結果碼錯誤

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

// 錯誤更少,修復更快

在 SQLly 裡操作 SQLite

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