C++多线程访问数据库报错解决-C++-PHP中文网

多线程共用一个mysql或sql::connection必然崩溃，因mysql c api和connector/c++本身不线程安全；正确做法是每个线程独占连接或用mutex保护完整查询周期。

c++多线程访问数据库报错解决

多线程直接共享同一个 MYSQL* 或 sql::Connection* 句柄访问数据库，几乎必然崩溃——这不是配置问题，是 MySQL C API 和 Connector/C++ 本身不保证线程安全。

为什么共用一个数据库连接会崩溃

MySQL 官方明确说明：单个 MYSQL 连接句柄**不是线程安全的**。多个线程同时调用 mysql_query()、mysql_real_query() 或 executeUpdate()，会导致：

内部缓冲区被并发读写，触发 Segmentation fault 或 double free
结果集指针（MYSQL_RES*）被一个线程释放，另一个线程仍在遍历 → 访问已释放内存
连接状态字段（如 net 结构体）被撕裂，后续调用 mysql_error() 返回乱码或空指针解引用

即使只读查询，只要两个线程在用同一个句柄，就可能因内部状态竞争而失败。这不是概率问题，是设计限制。

正确做法：每个线程独占连接 or 加锁隔离

两种方案都可行，选哪个取决于场景：

C++ Code Review Master

组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。

下载

推荐给高并发短任务：每个线程创建并管理自己的 MYSQL* 或 sql::Connection*，用完立即 mysql_close() 或 delete con。避免连接池复杂度，也规避了所有共享风险。
适合长生命周期线程：用 std::mutex 保护整个连接使用过程。注意必须锁住「从 mysql_query() 到 mysql_free_result()」完整周期，不能只锁 query：

std::mutex conn_mutex;
void safe_query(MYSQL* conn, const char* sql) {
    std::lock_guard<:mutex> lock(conn_mutex);
    if (mysql_query(conn, sql) != 0) return;
    MYSQL_RES* res = mysql_store_result(conn);
    if (res) {
        // 处理结果
        mysql_free_result(res);
    }
}
</:mutex>

漏掉 mysql_free_result() 或在锁外调用它，仍会出问题。

别踩这些坑

常见但危险的操作：

在主线程初始化 mysql_library_init() 后，子线程不调用 mysql_thread_init() → 某些旧版 libmysqlclient 崩溃
把 sql::Connection* 存在全局变量里，多个 std::thread 直接用 → 即使加了 std::shared_mutex 也救不了，因为 Connector/C++ 内部状态非可重入
用完连接后只 delete con，但没调 con->close() → 连接未真正释放，服务端资源泄漏
事务中跨线程复用连接：一个线程 setAutoCommit(false)，另一个线程 unknowingly 提交/回滚 → 数据一致性彻底破坏