C/C++与MySQL数据库交互实战指南

1. 项目概述：C/C++与MySQL数据库交互实战

作为一名长期从事数据库开发的工程师，我经常需要在C/C++程序中直接操作MySQL数据库。这种技术组合在游戏服务器、金融交易系统等高性能场景中尤为常见。本文将系统性地介绍如何用C/C++语言实现MySQL数据库的完整CRUD操作，包含大量实际开发中的经验技巧。

2. 环境准备与基础配置

2.1 MySQL开发库安装

在Ubuntu/Debian系统上安装MySQL客户端开发包：

bash复制sudo apt update
sudo apt install -y libmysqlclient-dev

关键目录说明：

• /usr/include/mysql：包含所有头文件
• /usr/lib/x86_64-linux-gnu：存放动态链接库
• /usr/bin/mysql_config：提供编译参数查询工具

注意：生产环境建议使用与MySQL服务器版本匹配的客户端库，避免兼容性问题。可通过mysql_config --version验证版本。

2.2 基础编译测试

创建测试程序mysql_version.cpp：

cpp复制#include <iostream>
#include <mysql/mysql.h>

int main() {
    std::cout << "MySQL client version: " 
              << mysql_get_client_info() << std::endl;
    return 0;
}

编译命令（关键参数说明）：

bash复制g++ mysql_version.cpp -o version_test \
    -I/usr/include/mysql \  # 指定头文件路径
    -L/usr/lib/x86_64-linux-gnu \  # 指定库路径
    -lmysqlclient  # 链接MySQL客户端库

3. 核心API深度解析

3.1 连接生命周期管理

MySQL C API使用MYSQL结构体作为连接句柄，其生命周期包含三个阶段：

1. 初始化：

cpp复制MYSQL *conn = mysql_init(nullptr);
if (!conn) {
    std::cerr << "Init failed: " << mysql_error(conn) << std::endl;
    return -1;
}

2. 建立连接：

cpp复制bool mysql_real_connect(
    MYSQL *mysql,           // 已初始化的句柄
    const char *host,       // 主机名或IP
    const char *user,       // 用户名
    const char *passwd,     // 密码
    const char *db,         // 默认数据库
    unsigned int port,      // 端口，0表示默认
    const char *unix_socket,// Unix域套接字路径
    unsigned long client_fla