// SQLite 錯誤參考

SQLITE_IOERR:磁碟 I/O 錯誤

作業系統在 SQLite 讀取、寫入、同步或鎖定檔案時回報了 I/O 錯誤。延伸碼會說明是哪個操作失敗。

結果代碼
SQLITE_IOERR
名稱
10
類別
主要結果代碼
錯誤訊息
disk I/O error

它的意義

SQLITE_IOERR (10) 表示檔案作業在作業系統層級失敗。SQLite 為此定義了許多延伸錯誤碼,例如 SQLITE_IOERR_READ, SQLITE_IOERR_WRITE, SQLITE_IOERR_FSYNC, SQLITE_IOERR_SHORT_READ (拿到的位元組比要求的少,例如檔案被截斷),以及 SQLITE_IOERR_LOCK。磁碟空間不足時通常會回傳 SQLITE_FULL 。

延伸代碼是最佳線索,因此請啟用延伸結果代碼,或使用 sqlite3_extended_errcode().

常見原因

  • 儲存裝置故障或斷線:USB 隨身碟被拔除、網路共用未掛載,或磁碟損壞。
  • 不支援 SQLite 所需之鎖定或同步功能的網路檔案系統或同步資料夾。
  • 防毒軟體或備份軟體佔用或更改檔案。
  • 檔案在連線開啟期間被截斷或遭取代。

如何修正

  1. 查看延伸錯誤碼以了解是哪個操作失敗,並檢查作業系統的記錄檔,看看有沒有磁碟錯誤。

  2. 把資料庫放在本機磁碟上。若必須共用,別共用檔案:在它前面架一台伺服器。

  3. 將資料庫、 -journal, -wal 和 -shm 檔案排除在防毒掃描與檔案同步工具之外。

  4. 任何 I/O 錯誤之後,先檢查檔案再信任它。

    PRAGMA integrity_check;

相關錯誤

更多主要結果碼錯誤

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

// 錯誤更少,修復更快

在 SQLly 裡操作 SQLite

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