// SQLite 錯誤參考

SQLITE_RANGE:欄位索引超出範圍

傳給 sqlite3_bind 函式的參數編號,或傳給 sqlite3_column 函式的欄位編號,超出有效範圍。

結果代碼
SQLITE_RANGE
名稱
25
類別
主要結果代碼
錯誤訊息
column index out of range

它的意義

SQLITE_RANGE (25) 表示語句中不存在某個繫結或欄位索引。參數編號從 1 開始,最大值是 ? 佔位符的數量(或最大 ?NNN。當你傳入的值比語句裡的預留位置多時,各語言綁定也會回報同樣的錯誤,例如 Python 的 Incorrect number of bindings supplied.

常見原因

  • 綁定參數 0,或綁定的參數比語句的預留位置多一個。
  • 傳入的值清單數量不符合 ? 佔位符。
  • 讀取的欄位索引超出結果欄位的數量。
  • 放置 ? 在引號內時,它是純文字的問號,而不是佔位符。

如何修正

  1. 計算預留位置的數量,並傳入剛好相同數量的值。繫結索引從 1 開始。

  2. 使用命名參數以避免計數錯誤。

    SELECT * FROM users WHERE email = :email AND status = :status;
  3. 請勿替預留位置加引號:直接寫成 WHERE name = ?,而不是 WHERE name = '?'.

相關錯誤

更多主要結果碼錯誤

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

// 錯誤更少,修復更快

在 SQLly 裡操作 SQLite

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