SQLite连接失败时，SQLITE_CANTOPEN通常表明路径不存在、目录无写权限或文件被系统级锁定；SQLITE_BUSY则大概率是其他连接正执行未提交的写事务。
SQLite连接失败时怎么判断是网络问题还是文件权限问题
SQLite本身不走网络，所谓“自动重连”实际是应对数据库文件被意外删除、移动、权限变更或被其他进程独占锁定的情况。常见错误码 SQLITE_CANTOPEN（14）和 SQLITE_BUSY（5）最需区分：SQLITE_CANTOPEN 通常意味着路径不存在、目录无写权限或文件被系统级锁定（如Windows下被资源管理器预览）；SQLITE_BUSY 则大概率是另一个连接正执行写事务且未提交，或 PRAGMA busy_timeout 未设置。
实操建议：
立即学习“C++免费学习笔记（深入）”；
- 用
sqlite3_open_v2替代sqlite3_open，显式传入SQLITE_OPEN_READWRITE | SQLITE_OPEN_CREATE标志，避免因只读模式在写操作时报错 - 首次打开失败后，先检查文件路径是否存在（
access(path, F_OK)）、是否可写（access(path, W_OK)），再查错误码——不是所有平台都把权限错误映射为SQLITE_CANTOPEN - 对
SQLITE_BUSY不要立即重试，先执行PRAGMA busy_timeout = 5000（单位毫秒），让SQLite内部重试机制接管
封装类里怎么安全地做连接重试而不阻塞主线程
重试逻辑必须异步化，否则一次磁盘I/O卡顿会拖垮整个调用链。C++11起推荐用 std::async + std::future 封装重试动作，但要注意：SQLite连接句柄 sqlite3* 不能跨线程共享，每个线程必须独立打开连接。
实操建议：
立即学习“C++免费学习笔记（深入）”；
- 重试任务在独立线程中执行，成功后通过线程安全队列（如
std::queue+std::mutex）通知主线程更新当前有效连接句柄 - 避免在重试循环里反复调用
sqlite3_open_v2—— 每次调用都涉及文件系统访问，应加指数退避（如第1次延时100ms，第2次200ms，第3次400ms） - 设置最大重试次数（建议≤3），超过后直接抛出异常或返回错误码，防止无限等待
- 重试期间所有写操作应缓存到内存队列（如
std::vector<:string></:string>存SQL语句），待连接恢复后批量执行
事务执行中连接断开，怎么保证数据一致性
SQLite没有服务端，所谓“连接断开”其实是句柄失效（sqlite3_close 被调用或进程崩溃）。关键在于：事务未提交前，数据只存在于日志文件（-journal 或 wal 文件）中，重启后SQLite会自动回滚未完成事务。
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
实操建议：
立即学习“C++免费学习笔记（深入）”；
- 开启WAL模式（
PRAGMA journal_mode = WAL），它比默认的DELETE模式更容错，崩溃后恢复更快 - 所有写操作必须包裹在
BEGIN IMMEDIATE/COMMIT中，避免隐式事务——SQLite默认每条语句一个事务，崩溃时可能只写入部分语句 - 不要依赖“重连后继续原事务”，连接重建后原事务上下文已丢失，必须重新构造事务逻辑
- 若业务要求强一致性，应在应用层实现幂等性：给每条写操作加唯一ID，重试前先查该ID是否已存在
如何检测SQLite连接是否还活着而不触发额外I/O
SQLite没有类似 PING 的轻量探测命令。最可靠的方式是执行一条不修改数据的快速查询，比如 SELECT 1，但它仍会触发一次磁盘读（哪怕数据在page cache里）。
实操建议：
立即学习“C++免费学习笔记（深入）”；
- 不主动检测“是否活着”，改为“按需重连”：每次执行SQL前检查
sqlite3_db_readonly和sqlite3_errcode，若返回SQLITE_MISUSE或SQLITE_ABORT，说明句柄已无效，立即重建 - 用
sqlite3_threadsafe()确认编译选项支持多线程，否则即使加锁也无法安全复用连接 - 避免在析构函数里调用
sqlite3_close前做健康检查——此时连接很可能已被其他线程关闭，再查状态会触发未定义行为
真正麻烦的是WAL模式下的共享内存段残留，进程异常退出后可能留下孤儿 -shm 文件，导致下次打开失败。这个点容易被忽略，得在重连前手动清理同名的 *-shm 和 *-wal 文件。
