// SQLite 错误参考
SQLITE_READONLY: 尝试写入只读数据库
连接无法写入:文件或其目录不可写,数据库以只读方式打开,或者 SQLite 无法创建其日志文件。
- 结果代码
SQLITE_READONLY- 名称
8- 类别
- 主要结果代码
它的意思
SQLITE_READONLY (8) 在语句尝试修改连接没有写权限的数据时返回。写入需要数据库文件及其所在目录的权限,因为 SQLite 会在旁边创建日志文件(-journal)或 WAL(-wal, -shm)文件。
扩展错误代码会说明原因: SQLITE_READONLY_DIRECTORY (没有权限创建日志), SQLITE_READONLY_DBMOVED (文件在打开时被移动或删除), SQLITE_READONLY_ROLLBACK (一个热日志需要回滚,但数据库是只读的),等等。
常见原因
- 数据库文件属于另一个用户或以只读方式挂载,Web 服务器用户或应用包内的文件通常如此。
- 目录不可写,因此即使文件本身可写,SQLite 也无法创建日志文件。
- 连接以只读方式打开(
SQLITE_OPEN_READONLY,?mode=roURI,或者PRAGMA query_only = ON). - 文件在连接打开时被移动、重命名或删除(
SQLITE_READONLY_DBMOVED).
如何修复它
-
为该文件及其目录授予进程写权限。在 Linux 和 macOS 上,检查
ls -l,两边都要检查,然后修复所有权或权限位。 -
检查连接本身是否为只读。
PRAGMA query_only; PRAGMA database_list;
-
以读写方式打开数据库:删除
mode=ro从 URI 或打开调用中的只读标志。 -
如果文件在打开状态下被移动,请关闭连接,再在新路径重新打开它。
相关错误
SQLITE_CANTOPEN无法打开数据库文件SQLITE_PERM访问权限被拒绝SQLITE_READONLY_DBMOVED数据库文件在打开时被移动SQLITE_READONLY_ROLLBACK热日志无法回滚25006PostgreSQL:只读 SQL 事务
更多主要结果代码错误
SQLITE_ERRORSQL 逻辑错误SQLITE_ABORT查询已中止SQLITE_BUSY数据库已锁定SQLITE_LOCKED数据库表被锁定SQLITE_NOMEM内存不足SQLITE_INTERRUPT已中断SQLITE_IOERR磁盘 I/O 错误SQLITE_CORRUPT数据库磁盘映像已损坏
代码和消息文本来自 SQLite 结果和错误代码文档。浏览完整的 SQLite 错误列表 或者 搜索每个数据库错误.
// 错误更少,修复更快
在 SQLly 中使用 SQLite
适用于 macOS、Windows 和 Linux 的原生 SQL 客户端,智能感知能理解你的数据库模式,高危语句有防护,错误信息清晰,支持 SQLite 以及你使用的其他数据库。