// SQLite 錯誤參考

SQLITE_BUSY_TIMEOUT:封鎖性檔案鎖逾時

SQLite 的 VFS 層中,一個封鎖式 POSIX 檔案鎖定要求逾時。只有以 SQLITE_ENABLE_SETLK_TIMEOUT 編譯的組建才會回傳這個錯誤。

結果代碼
SQLITE_BUSY_TIMEOUT
名稱
773
類別
擴展結果程式碼
錯誤訊息
database is locked

它的意義

SQLite 文件描述 SQLITE_BUSY_TIMEOUT (773) 視為一個因逾時而失敗的封鎖式 POSIX 建議檔案鎖請求。只有當 SQLite 編譯時加入了 SQLITE_ENABLE_SETLK_TIMEOUT,所以大多數應用程式根本看不到這段程式碼;它們拿到的是純 SQLITE_BUSY 當無法取得鎖時。

常見原因

  • 在啟用封鎖鎖定的建置上,另一個連線持有鎖定的時間超過設定的等待時間。

如何修正

  1. 處理方式比照 SQLITE_BUSY:保持寫入交易簡短、使用 WAL 模式,然後重試。

  2. 若預期鎖的持有者會耗上一段時間,請調高等待時間。

    PRAGMA busy_timeout = 10000;

相關錯誤

更多延伸結果碼錯誤

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

// 錯誤更少,修復更快

在 SQLly 裡操作 SQLite

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