C/C++与MySQL数据库交互实战指南-代码聚汇网

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结构体作为连接句柄，其生命周期包含三个阶段：

初始化：

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

建立连接：

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_flag // 连接标志
);

典型连接示例：

cpp复制if (!mysql_real_connect(conn, "127.0.0.1", "app_user", "password", 
                       "inventory_db", 3306, nullptr, 0)) {
    std::cerr << "Connection failed: " << mysql_error(conn) << std::endl;
    mysql_close(conn);
    return -1;
}

关闭连接：

cpp复制mysql_close(conn);  // 释放所有关联资源

经验：务必在程序退出前显式关闭连接，避免内存泄漏和连接数耗尽问题。

3.2 字符集处理最佳实践

中文乱码问题的根本解决方案：

cpp复制// 建立连接后立即设置字符集
if (mysql_set_character_set(conn, "utf8mb4")) {
    std::cerr << "Charset error: " << mysql_error(conn) << std::endl;
}

字符集设置要点：

MySQL 5.7+推荐使用utf8mb4（完整UTF-8支持）
需要保证数据库、表、连接三处字符集一致
对于BLOB类型数据应禁用字符集转换

4. SQL执行与结果处理

4.1 基础SQL执行

使用mysql_query()执行任意SQL语句：

cpp复制int mysql_query(MYSQL *mysql, const char *stmt_str);

典型执行流程：

cpp复制std::string sql = "INSERT INTO users (name, age) VALUES ('张三', 25)";
if (mysql_query(conn, sql.c_str())) {
    std::cerr << "Query failed: " << mysql_error(conn) << std::endl;
} else {
    std::cout << "Affected rows: " 
              << mysql_affected_rows(conn) << std::endl;
}

4.2 查询结果处理

完整结果集处理流程：

cpp复制MYSQL_RES *result = mysql_store_result(conn);
if (!result) {
    if (mysql_field_count(conn) == 0) {
        // 无结果集的查询（如INSERT/UPDATE）
    } else {
        // 错误处理
    }
}

// 获取列信息
MYSQL_FIELD *fields = mysql_fetch_fields(result);
int num_fields = mysql_num_fields(result);

// 打印表头
for (int i = 0; i < num_fields; i++) {
    std::cout << fields[i].name << "\t";
}
std::cout << std::endl;

// 遍历行数据
MYSQL_ROW row;
while ((row = mysql_fetch_row(result))) {
    for (int i = 0; i < num_fields; i++) {
        std::cout << (row[i] ? row[i] : "NULL") << "\t";
    }
    std::cout << std::endl;
}

// 释放结果集
mysql_free_result(result);

5. 高级特性与性能优化

5.1 预处理语句

防止SQL注入的最佳实践：

cpp复制MYSQL_STMT *stmt = mysql_stmt_init(conn);
std::string query = "INSERT INTO products (name, price) VALUES (?, ?)";

if (mysql_stmt_prepare(stmt, query.c_str(), query.length())) {
    // 错误处理
}

// 绑定参数
MYSQL_BIND bind[2];
char name[100];
double price;

memset(bind, 0, sizeof(bind));
bind[0].buffer_type = MYSQL_TYPE_STRING;
bind[0].buffer = name;
bind[0].buffer_length = sizeof(name);
bind[0].length = &name_len;

bind[1].buffer_type = MYSQL_TYPE_DOUBLE;
bind[1].buffer = &price;
bind[1].is_null = 0;
bind[1].length = 0;

// 执行
if (mysql_stmt_bind_param(stmt, bind) ||
    mysql_stmt_execute(stmt)) {
    // 错误处理
}

mysql_stmt_close(stmt);

5.2 事务处理示例

ACID特性保障：

cpp复制// 开启事务
mysql_autocommit(conn, 0);

try {
    // 执行多个SQL
    mysql_query(conn, "UPDATE accounts SET balance=balance-100 WHERE id=1");
    mysql_query(conn, "UPDATE accounts SET balance=balance+100 WHERE id=2");
    
    // 提交
    mysql_commit(conn);
} catch (...) {
    // 回滚
    mysql_rollback(conn);
    throw;
} finally {
    mysql_autocommit(conn, 1);
}

6. 生产环境注意事项

连接池管理：
- 避免频繁创建/销毁连接
- 推荐使用libzdb等成熟连接池方案
错误处理规范：

cpp复制#define MYSQL_CHECK(conn, expr) \
    do { \
        if (expr) { \
            std::cerr << "Error at " << __FILE__ << ":" << __LINE__ \
                     << " - " << mysql_error(conn) << std::endl; \
            mysql_close(conn); \
            exit(EXIT_FAILURE); \
        } \
    } while(0)

// 使用示例
MYSQL_CHECK(conn, mysql_query(conn, "SELECT * FROM non_existent_table"));

性能调优：
- 批量操作使用LOAD DATA INFILE替代多次INSERT
- 查询时明确指定列名而非使用SELECT *
- 合理设置net_write_timeout和net_read_timeout

7. 完整示例项目

库存管理系统核心代码：

cpp复制class MySQLInventory {
public:
    MySQLInventory(const std::string &host, const std::string &user, 
                  const std::string &pass, const std::string &db) {
        conn_ = mysql_init(nullptr);
        if (!conn_ || !mysql_real_connect(conn_, host.c_str(), user.c_str(),
                pass.c_str(), db.c_str(), 3306, nullptr, CLIENT_MULTI_STATEMENTS)) {
            throw std::runtime_error(mysql_error(conn_));
        }
        mysql_set_character_set(conn_, "utf8mb4");
    }
    
    ~MySQLInventory() {
        mysql_close(conn_);
    }
    
    bool add_product(const std::string &name, double price, int stock) {
        MYSQL_STMT *stmt = mysql_stmt_init(conn_);
        const char *query = "INSERT INTO products (name, price, stock) VALUES (?, ?, ?)";
        
        MYSQL_BIND bind[3];
        unsigned long name_len = name.length();
        
        memset(bind, 0, sizeof(bind));
        bind[0].buffer_type = MYSQL_TYPE_STRING;
        bind[0].buffer = const_cast<char*>(name.c_str());
        bind[0].buffer_length = name.length();
        bind[0].length = &name_len;
        
        bind[1].buffer_type = MYSQL_TYPE_DOUBLE;
        bind[1].buffer = &price;
        
        bind[2].buffer_type = MYSQL_TYPE_LONG;
        bind[2].buffer = &stock;
        
        bool success = (mysql_stmt_prepare(stmt, query, strlen(query)) == 0) &&
                      (mysql_stmt_bind_param(stmt, bind) == 0) &&
                      (mysql_stmt_execute(stmt) == 0);
        
        mysql_stmt_close(stmt);
        return success;
    }
    
    // 其他CRUD方法...
    
private:
    MYSQL *conn_;
};

8. 常见问题排查

连接失败：
- 检查防火墙设置：sudo ufw allow 3306
- 验证用户权限：GRANT ALL ON db.* TO 'user'@'%' IDENTIFIED BY 'password'
- 确认MySQL服务运行：systemctl status mysql
中文乱码：
- 检查三处字符集设置：
```
sql复制SHOW VARIABLES LIKE 'character_set%';
SHOW CREATE TABLE your_table;
```
- 确保C++程序源代码文件保存为UTF-8编码
内存泄漏检测：
- 使用valgrind工具检查：
```
bash复制valgrind --leak-check=full ./your_program
```
- 确保每个mysql_init()都有对应的mysql_close()
- 确保每个mysql_store_result()都有对应的mysql_free_result()
性能瓶颈分析：
- 启用MySQL慢查询日志：
```
sql复制SET GLOBAL slow_query_log = 'ON';
SET GLOBAL long_query_time = 1;
```
- 使用EXPLAIN分析查询执行计划

在实际项目开发中，我建议将数据库操作封装为独立的DAO层，这样既有利于代码复用，也方便后续进行性能监控和优化。对于高并发场景，还需要考虑连接池管理和事务隔离级别设置等高级话题。