// 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 客户端,智能感知能理解你的数据库模式,高危语句有防护,错误信息清晰,支持 SQLite 以及你使用的其他数据库。