C++中SQLite3多线程分离执行查询与增改操作的安全性问题

嘿，这个问题戳中了SQLite多线程开发的高频坑点，我来给你拆解清楚——直接说核心结论：如果两个线程共用同一个sqlite3*连接句柄，必然会引发数据竞争和未定义行为；但如果每个线程使用独立的数据库连接，那就是完全安全的。

先给你理清楚SQLite的线程安全逻辑：

• SQLite默认的线程安全模式是「多线程模式」，这种模式下，不同线程可以同时操作不同的数据库连接，但同一个sqlite3*对象绝对不能被多个线程同时访问——哪怕一个线程只做SELECT读操作，另一个做INSERT/UPDATE写操作，共用连接都会打乱SQLite内部的状态，轻则返回错误查询结果，重则直接崩溃、损坏数据库文件。
• 如果你非要共用同一个连接（比如想节省连接资源），得先把SQLite切换到「序列化模式」。这个模式下，SQLite内部会自动加全局锁，保证同一个连接上的所有操作串行执行，不会有并发冲突。但要注意，这个配置必须在打开任何数据库连接之前调用，示例代码如下：

  // 必须在sqlite3_open之前调用，全局仅能调用一次
  int rc = sqlite3_config(SQLITE_CONFIG_SERIALIZED);
  if (rc != SQLITE_OK) {
      // 处理配置失败的异常情况
  }
  // 之后再打开数据库连接
  sqlite3* db;
  rc = sqlite3_open("path/to/example.db", &db);
  

再给你推荐更稳妥的实践方案：

• 优先选择「每个线程独立打开连接」：读线程自己调用sqlite3_open获取专属的sqlite3*，写线程也单独打开一个连接。这种方式最省心，不需要修改SQLite全局配置，配合WAL（写提前日志）模式还能实现真正的并发读+写——默认的DELETE日志模式下，写操作会独占数据库锁，读操作会被阻塞；开启WAL后，多个读线程和一个写线程可以同时工作，性能提升明显。开启WAL的代码很简单，打开连接后执行这条PRAGMA语句即可：

  sqlite3_exec(db, "PRAGMA journal_mode=WAL;", nullptr, nullptr, nullptr);
  

• 绝对要避免跨线程共用连接：哪怕你自己用互斥锁包裹连接的访问逻辑，也不推荐——SQLite内部的一些隐式操作可能会绕过你的锁逻辑，很容易出现遗漏，不如直接用独立连接或依赖SQLite的序列化模式更可靠。

最后再敲个警钟：如果你的代码已经在两个线程共用同一个sqlite3*了，赶紧整改！这种情况下的未定义行为是不可预测的，可能测试环境一切正常，上线后突然出现崩溃或数据损坏，排查起来会非常棘手。

内容来源于stack exchange