// SQLite 錯誤參考

SQLITE_READONLY:嘗試寫入唯讀資料庫

連線無法寫入:檔案或其所在目錄不可寫入、資料庫以唯讀方式開啟,或 SQLite 無法建立其日誌檔。

結果代碼
SQLITE_READONLY
名稱
8
類別
主要結果代碼
錯誤訊息
attempt to write a readonly database

它的意義

SQLITE_READONLY (8) 會在語句嘗試修改連線沒有寫入權限的資料時回傳。寫入需要資料庫檔案本身以及其所在目錄的權限,因為 SQLite 會在旁邊建立日誌檔 (-journal) 或 WAL (-wal, -shm)檔案放在它旁邊。

延伸結果碼 SQLITE_READONLY_DIRECTORY (無權限建立日誌), SQLITE_READONLY_DBMOVED (檔案在開啟期間被移動或刪除), SQLITE_READONLY_ROLLBACK (熱日誌需要回復,但資料庫是唯讀)等情況。

常見原因

  • 資料庫檔案的擁有者是另一個使用者,或以唯讀方式掛載,這在網頁伺服器使用者或應用程式套件內的檔案很常見。
  • 目錄不可寫入,因此即使檔案本身可寫入,SQLite 也無法建立日誌檔。
  • 連線以唯讀模式開啟(SQLITE_OPEN_READONLY, ?mode=ro URI,或 PRAGMA query_only = ON).
  • 檔案在連線開啟期間被移動、重新命名或刪除(SQLITE_READONLY_DBMOVED).

如何修正

  1. 給處理程序該檔案與其目錄的寫入權限。在 Linux 和 macOS 上可用下列指令檢查 ls -l ,兩者都要檢查,然後修正擁有權或權限。

  2. 檢查連線本身是否為唯讀。

    PRAGMA query_only;
    PRAGMA database_list;
  3. 以讀寫方式開啟資料庫:刪除 mode=ro 取自 URI,或開啟呼叫傳入的唯讀旗標。

  4. 如果檔案在開啟時被移動,請關閉連線並在其新路徑重新開啟。

相關錯誤

更多主要結果碼錯誤

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

// 錯誤更少,修復更快

在 SQLly 裡操作 SQLite

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