// SQLite 錯誤參考

SQLITE_PROTOCOL:鎖定協定

在 WAL 模式下,某個連線在幾秒內多次搶著啟動交易都落敗,最後放棄。非常罕見;代表寫入競爭相當激烈。

結果代碼
SQLITE_PROTOCOL
名稱
15
類別
主要結果代碼
錯誤訊息
locking protocol

它的意義

SQLite 文件描述 SQLITE_PROTOCOL (15) 視為檔案鎖定協定的問題,目前只會在 WAL 模式下開始交易時回傳。當兩個連線搶著開始交易時,輸的一方會退讓並重試;如果同一個連線連續好幾秒都輸,就會回傳 SQLITE_PROTOCOL。這應該只會在多個處理程序激烈搶寫同一個資料庫時出現。

常見原因

  • 許多處理程序同時寫入同一個 WAL 模式的資料庫。
  • 檔案鎖定行為異常,例如在網路檔案系統上。

如何修正

  1. 減少同時寫入的處理序數量,例如透過單一處理序或佇列來集中寫入。

  2. 把資料庫放在鎖能正常運作的本機磁碟上。

  3. 將它視為 SQLITE_BUSY:稍候片刻再重試交易。

相關錯誤

更多主要結果碼錯誤

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

// 錯誤更少,修復更快

在 SQLly 裡操作 SQLite

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