// 错误参考
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_CANTOPEN_SYMLINK
|
1550
|
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,并为高风险语句提供护栏。