// 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 (一个热日志需要回滚,但数据库是只读的),等等。

常见原因

  • 数据库文件属于另一个用户或以只读方式挂载,Web 服务器用户或应用包内的文件通常如此。
  • 目录不可写,因此即使文件本身可写,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 客户端,智能感知能理解你的数据库模式,高危语句有防护,错误信息清晰,支持 SQLite 以及你使用的其他数据库。