C++ 連接 MySQL 實戰：官方 C API 開發指南與 VS 平台避坑

C++ 連接 MySQL 實戰：官方 C API 開發指南與 VS 平台避坑

C/C++ 訪問 MySQL 推薦使用官方 libmysqlclient C API，無需額外 ODBC 驅動，性能最優、依賴最少。本文涵蓋 VS2010/2015 環境配置、核心 API 調用流程、完整代碼示例、64 位編譯陷阱與常用 API 速查表。

一、環境配置

1. 頭文件目錄：MySQL 安裝目录\include（如 C:\Program Files\MySQL\MySQL Server 5.7\include）
2. 庫文件：將 libmysql.lib、libmysql.dll 複製至專案目錄
3. 代碼引用：

   #include "winsock.h"  // Windows Socket 依賴
   #include "mysql.h"
   #pragma comment(lib, "libmysql.lib")

二、核心流程代碼

1. 連接數據庫

MYSQL m_sqlCon;

bool ConnectDB() {
    try {
        mysql_init(&m_sqlCon);
        // host, user, pass, db, port, unix_socket, client_flag
        if (!mysql_real_connect(&m_sqlCon, "localhost", "root", "root", "test", 3306, NULL, 0)) {
            AfxMessageBox(_T("數據庫連接失敗! ") + CString(mysql_error(&m_sqlCon)));
            return false;
        }
        // 設置字符集（防中文亂碼）
        mysql_set_character_set(&m_sqlCon, "utf8mb4");
        return true;
    } catch (...) {
        return false;
    }
}

2. 關閉連接

void CloseDB() {
    mysql_close(&m_sqlCon);
}

3. 執行 DDL/DML（無結果集）

bool ExecuteSQL(const char* sql) {
    if (mysql_real_query(&m_sqlCon, sql, (unsigned long)strlen(sql)) != 0) {
        const char* err = mysql_error(&m_sqlCon);
        // 記錄錯誤
        return false;
    }
    return true;
}

// 創建表示例
ExecuteSQL("CREATE TABLE IF NOT EXISTS DS_Building("
           "ID VARCHAR(10) PRIMARY KEY,"
           "Name VARCHAR(255),"
           "Descs VARCHAR(255)) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;");

4. 查詢處理（有結果集）

bool QueryData(const char* sql) {
    if (mysql_real_query(&m_sqlCon, sql, (unsigned long)strlen(sql)) != 0) return false;
    
    MYSQL_RES* result = mysql_store_result(&m_sqlCon);  // 獲取完整結果集
    if (!result) return false;
    
    int num_fields = mysql_num_fields(result);
    MYSQL_FIELD* fields = mysql_fetch_fields(result);   // 列元數據
    
    MYSQL_ROW row;
    while ((row = mysql_fetch_row(result))) {
        for (int i = 0; i < num_fields; ++i) {
            printf("%s: %s\t", fields[i].name, row[i] ? row[i] : "NULL");
        }
        printf("\n");
    }
    mysql_free_result(result);  // 必須釋放
    return true;
}

三、VS 64 位編譯陷阱（高頻坑）

現象：LNK2019 無法解析的外部符號 _mysql_init@4 等