// SQLite 錯誤參考

SQLITE_CANTOPEN:無法開啟資料庫檔案

SQLite 無法開啟資料庫檔案或它的暫存檔:可能是路徑錯誤、目錄不存在、權限問題,或路徑本身是個目錄。

結果代碼
SQLITE_CANTOPEN
名稱
14
類別
主要結果代碼
錯誤訊息
unable to open database file

它的意義

SQLITE_CANTOPEN (14) 表示作業系統拒絕開啟 SQLite 需要的檔案。通常是主資料庫檔案,但也可能是暫存檔。路徑不存在時 SQLite 會建立新的資料庫檔案,所以這個錯誤通常代表目錄不存在或不可寫入,而不是檔案不存在。

延伸碼可進一步縮小範圍,例如 SQLITE_CANTOPEN_ISDIR (路徑是目錄)以及 SQLITE_CANTOPEN_FULLPATH (無法解析完整路徑)。

常見原因

  • 路徑中的目錄不存在;SQLite 建立的是檔案,而不是目錄。
  • 相對路徑被非預期的工作目錄解析,例如在服務或測試執行器裡。
  • 沒有讀取檔案的權限,或沒有在該目錄建立檔案的權限。
  • 路徑指向一個目錄(SQLITE_CANTOPEN_ISDIR).
  • 暫存目錄不存在或無法寫入,因此無法建立暫存檔。
  • 該處理程序開啟的檔案過多。

如何修正

  1. 使用絕對路徑,並確保路徑中的每個目錄都存在。

  2. 檢查程式執行身分的使用者對檔案及其目錄的權限。

  3. 如果問題出在暫存檔,請將 SQLite 指向可寫入的目錄,方法是設定 SQLITE_TMPDIR 或 TMPDIR 環境變數,或把暫存資料留在記憶體裡。

    PRAGMA temp_store = MEMORY;
  4. 在 sqlite3 shell 中,確認開啟了哪些內容。

    .databases

相關錯誤

更多主要結果碼錯誤

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

// 錯誤更少,修復更快

在 SQLly 裡操作 SQLite

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