生产环境出现 SQLite Error 5 通常是并发写入冲突或事务未提交导致的，优先检查占用进程和代码中的连接管理，嵌入式场景需额外确认内核文件锁支持。
先说结论：该错误核心在于数据库文件被独占锁持有，生产环境应先释放被占用的文件句柄，再从代码层面优化并发控制和超时设置。
- 先确认：检查是否有其他进程或线程持有数据库文件锁
- 先处理：调整 busy_timeout 参数或引入同步锁机制
- 再验证：通过日志监控和完整性检查确认锁竞争消失
命令速用版
如果是 Linux 环境且数据库文件路径已知，可用以下命令查找占用进程：
lsof | grep your_database.db如果是 SVN 工作副本报错，可尝试清理临时目录：
rm -rf .svn/tmp/*在 SQLite 命令行或代码中执行完整性检查：
PRAGMA integrity_check;为什么会这样
SQLite 设计上是轻量级嵌入式数据库，同一时刻只允许一个线程进行写操作。当出现"database is locked"（错误码 5）时，通常是因为写操作期间文件被锁定，其他读写请求无法获取锁。
常见诱因包括多线程同时写入、事务开启后未正常关闭、或者操作系统层面的文件锁机制未正确支持。在嵌入式 Linux 中，如果内核未开启 POSIX 文件锁 API，也可能导致锁状态异常。此外，SVN 等工具在使用 SQLite 存储元数据时，若操作异常中断，临时文件残留也会引发锁定。
分步处理
1. 排查占用进程
在 Linux 或 macOS 上使用 lsof 查看哪个进程持有了数据库文件句柄。确认无害后，使用 kill 命令结束占用进程。Windows 环境下可通过资源监视器查看句柄占用。
2. 优化代码连接管理
确保数据库连接使用后及时关闭。在多线程环境中，建议使用单例模式管理数据库实例，避免多个连接同时操作。对于 Python 等语言，可在连接时增加超时参数，例如设置 timeout=60，让数据库在锁竞争时等待而非立即报错。
3. 调整 busy_handler
如果默认超时机制无效，可注册自定义的 busy_handler 回调函数。当数据库忙时，该函数会被调用进行延时重试。注意默认回调在某些编译环境下可能需要超时参数大于 1000 毫秒才有意义，建议自行实现延时逻辑。
4. 嵌入式内核检查
若在嵌入式设备遇到此问题且确认无多进程冲突，检查 Linux 内核配置是否开启了文件锁支持。路径通常在 File systems 下，确认 Enable POSIX file locking API 已选中，重新编译内核后测试。
5. 清理 SVN 临时文件
如果是 SVN 操作报错，检查 .svn/tmp 目录是否有残留文件。删除该目录下的临时文件可能解除锁定，但需确保没有正在进行的 SVN 操作。
怎么验证是否生效
观察应用日志，确认不再频繁出现 SQLiteDatabaseLockedException 或 QSqlError 5 相关报错。在高并发场景下进行压力测试，监控数据库操作成功率。定期执行 PRAGMA integrity_check 命令，确保数据库文件未因异常锁定导致损坏。对于 SVN 场景，尝试执行 update 或 commit 操作，确认无锁定报错。
常见坑
1. 多线程同时写：SQLite 支持多线程读，但写操作必须串行。未在代码层面加锁极易触发此错误。
2. 事务未关闭：开启事务后若发生异常未 rollback 或 commit，锁将一直被持有。
3. 游标未关闭：在某些语言绑定中，查询游标未关闭可能导致连接未释放。
4. 超时设置过短：默认超时时间可能不足以应对生产环境的 IO 波动，建议适当延长。
5. 模型缓存限制：在使用 Qt 的 QSqlTableModel 时，缓存数据量限制（如 256 条）可能导致事务未结束就进行新操作，需手动 fetchMore 获取所有结果。
参考来源
- CSDN 博客：SQLITE 数据库 QSqlError("5", "Unable to fetch row", "database is locked")问题原因及解决方法
- 技术文章：SQLite 出现"Database is locked"如何解决？
- CSDN 博客：解决嵌入式使用 SQL 出现 Error(5): database is locked_error: database is locked-CSDN 博客
- 技术文章：sqlite database is locked 问题解决方案
- 技术文章：SQLiteDatabaseLockedException: database is locked (code 5): , while compiling: PRAGMA journal_mode
- 技术文章：QSqlError("5", "Unable to fetch row", "database is locked")问题解决（含 URL: https://www.recoveryandmanagement.com/sqlite-database-disk-image-is-malformed/?spm=a2c5q.11423531.0.0.501c5097APVic1）
- 博客园：Sqlite 出现 database is locked - 清水截
- 技术文章：问题:SVN 报错 sqlite[S5]: database is locked 如何解决？
- 技术文章：SQLiteException: database is locked 异常的解决办法（含 URL: http://blog.csdn.net/sdsxleon/article/details/18259973）
- 技术文章：SQLiteException:errorcode 5: database is locked
原文链接：https://www.zjcp.cc/ask/10826.html