// 错误参考

SQLite 错误代码

来自官方列表的所有 SQLite 结果代码,包括主要代码和扩展代码,并附其文本 sqlite3_errstr() 为每个主代码返回的文本。你可能会遇到的那些都有完整页面,说明原因和解决方法。

解读 SQLite 错误

SQLite 函数返回一个整数结果代码。低八位是主代码,例如 SQLITE_BUSY (5)。扩展代码在高位添加详细信息: SQLITE_BUSY_SNAPSHOT 是 517,即 5 + 2 × 256。启用后就会返回扩展代码,启用方式为 sqlite3_extended_result_codes() 或读取方式如下 sqlite3_extended_errcode().

程序显示的消息通常来自 sqlite3_errmsg(),它可以比通用文本更具体,例如 UNIQUE constraint failed: users.email 代替 constraint failed.

语言绑定封装这些代码:Python 的 sqlite3 模块会引发 OperationalError 或者 IntegrityError 并且从 Python 3.11 起还提供 sqlite_errorcode 和 sqlite_errorname 关于这个例外。

本参考中的所有 SQLite 错误

105 个结果代码,其中 40 个有完整解释。 SQLite 结果和错误代码文档.

主要结果代码

代码含义
SQLITE_OK 0 不是错误
SQLITE_ERROR SQL 逻辑错误 1 SQL 逻辑错误
SQLITE_INTERNAL 2
SQLITE_PERM 访问权限被拒绝 3 访问权限被拒绝
SQLITE_ABORT 查询已中止 4 查询已中止
SQLITE_BUSY 数据库已锁定 5 数据库已锁定
SQLITE_LOCKED 数据库表被锁定 6 数据库表被锁定
SQLITE_NOMEM 内存不足 7 内存不足
SQLITE_READONLY 尝试写入只读数据库 8 尝试写入只读数据库
SQLITE_INTERRUPT 已中断 9 已中断
SQLITE_IOERR 磁盘 I/O 错误 10 磁盘 I/O 错误
SQLITE_CORRUPT 数据库磁盘映像已损坏 11 数据库磁盘映像已损坏
SQLITE_NOTFOUND 12 未知操作
SQLITE_FULL 数据库或磁盘已满 13 数据库或磁盘已满
SQLITE_CANTOPEN 无法打开数据库文件 14 无法打开数据库文件
SQLITE_PROTOCOL 锁定协议 15 锁定协议
SQLITE_EMPTY 16
SQLITE_SCHEMA 数据库模式已更改 17 数据库模式已更改
SQLITE_TOOBIG 字符串或 BLOB 太大 18 字符串或 BLOB 太大
SQLITE_CONSTRAINT 约束失败 19 约束失败
SQLITE_MISMATCH 数据类型不匹配 20 数据类型不匹配
SQLITE_MISUSE 参数错误或其他 API 误用 21 参数错误或其他 API 误用
SQLITE_NOLFS 22
SQLITE_AUTH 授权被拒绝 23 授权被拒绝
SQLITE_FORMAT 24
SQLITE_RANGE 列索引超出范围 25 列索引超出范围
SQLITE_NOTADB 文件不是数据库 26 文件不是数据库
SQLITE_NOTICE 27 通知消息
SQLITE_WARNING 28 警告消息
SQLITE_ROW 100 还有另一行可用
SQLITE_DONE 101 没有更多可用的行

扩展结果代码

代码含义
SQLITE_OK_LOAD_PERMANENTLY 256
SQLITE_ERROR_MISSING_COLLSEQ 没有这样的排序规则 257 没有这样的排序规则:unicode_ci
SQLITE_BUSY_RECOVERY 另一个进程正在恢复 WAL 261 数据库已锁定
SQLITE_LOCKED_SHAREDCACHE 记录在共享缓存中被锁定 262 数据库表被锁定
SQLITE_READONLY_RECOVERY 264
SQLITE_IOERR_READ 266
SQLITE_CORRUPT_VTAB 267
SQLITE_CANTOPEN_NOTEMPDIR 270
SQLITE_CONSTRAINT_CHECK CHECK 约束失败 275 CHECK 约束失败:price_positive
SQLITE_AUTH_USER 279
SQLITE_NOTICE_RECOVER_WAL 283
SQLITE_WARNING_AUTOINDEX 284
SQLITE_ERROR_RETRY 513
SQLITE_ABORT_ROLLBACK 语句因 ROLLBACK 而中止 516 因回滚而中止
SQLITE_BUSY_SNAPSHOT 陈旧读取不能转为写入 517 数据库已锁定
SQLITE_LOCKED_VTAB 518
SQLITE_READONLY_CANTLOCK 520
SQLITE_IOERR_SHORT_READ 读取返回的字节数不足 522 磁盘 I/O 错误
SQLITE_CORRUPT_SEQUENCE 523
SQLITE_CANTOPEN_ISDIR 路径是一个目录 526 无法打开数据库文件
SQLITE_CONSTRAINT_COMMITHOOK 531
SQLITE_NOTICE_RECOVER_ROLLBACK 539
SQLITE_ERROR_SNAPSHOT 769
SQLITE_BUSY_TIMEOUT 阻塞文件锁超时 773 数据库已锁定
SQLITE_READONLY_ROLLBACK 热日志无法回滚 776 尝试写入只读数据库
SQLITE_IOERR_WRITE 778
SQLITE_CORRUPT_INDEX 索引条目缺失 779 数据库磁盘映像已损坏
SQLITE_CANTOPEN_FULLPATH 782
SQLITE_CONSTRAINT_FOREIGNKEY 外键约束失败 787 外键约束失败
SQLITE_READONLY_DBMOVED 数据库文件在打开时被移动 1032 尝试写入只读数据库
SQLITE_IOERR_FSYNC 1034
SQLITE_CANTOPEN_CONVPATH 1038
SQLITE_CONSTRAINT_FUNCTION 1043
SQLITE_READONLY_CANTINIT 1288
SQLITE_IOERR_DIR_FSYNC 1290
SQLITE_CANTOPEN_DIRTYWAL 1294
SQLITE_CONSTRAINT_NOTNULL NOT NULL 约束失败 1299 NOT NULL 约束失败:users.name
SQLITE_READONLY_DIRECTORY 无法创建日志文件 1544 尝试写入只读数据库
SQLITE_IOERR_TRUNCATE 1546
SQLITE_CONSTRAINT_PRIMARYKEY 主键约束失败 1555 UNIQUE 约束失败:orders.id
SQLITE_IOERR_FSTAT 1802
SQLITE_CONSTRAINT_TRIGGER 触发器中的 RAISE() 导致中止 1811 约束失败
SQLITE_IOERR_UNLOCK 2058
SQLITE_CONSTRAINT_UNIQUE UNIQUE 约束失败 2067 UNIQUE 约束失败:users.email
SQLITE_IOERR_RDLOCK 2314
SQLITE_CONSTRAINT_VTAB 2323
SQLITE_IOERR_DELETE 2570
SQLITE_CONSTRAINT_ROWID 2579
SQLITE_IOERR_BLOCKED 2826
SQLITE_CONSTRAINT_PINNED 2835
SQLITE_IOERR_NOMEM 3082
SQLITE_CONSTRAINT_DATATYPE 值不符合 STRICT 列的类型要求 3091 无法在 INTEGER 列 t.qty 中存储 TEXT 值
SQLITE_IOERR_ACCESS 3338
SQLITE_IOERR_CHECKRESERVEDLOCK 3594
SQLITE_IOERR_LOCK 3850
SQLITE_IOERR_CLOSE 4106
SQLITE_IOERR_DIR_CLOSE 4362
SQLITE_IOERR_SHMOPEN 4618
SQLITE_IOERR_SHMSIZE 4874
SQLITE_IOERR_SHMLOCK 5130
SQLITE_IOERR_SHMMAP 5386
SQLITE_IOERR_SEEK 5642
SQLITE_IOERR_DELETE_NOENT 5898
SQLITE_IOERR_MMAP 6154
SQLITE_IOERR_GETTEMPPATH 6410
SQLITE_IOERR_CONVPATH 6666
SQLITE_IOERR_VNODE 6922
SQLITE_IOERR_AUTH 7178
SQLITE_IOERR_BEGIN_ATOMIC 7434
SQLITE_IOERR_COMMIT_ATOMIC 7690
SQLITE_IOERR_ROLLBACK_ATOMIC 7946
SQLITE_IOERR_DATA 8202
SQLITE_IOERR_CORRUPTFS 8458
// 一个客户端,覆盖所有引擎

更快地使用 SQLite

SQLly 是 macOS、Windows 和 Linux 的原生 SQL 客户端,具备模式感知的 IntelliSense,并为高风险语句提供护栏。