Linux C 語言操作 MySQL 完整指南：API 核心函數、編譯鏈接與實戰範例

在 Linux 環境下使用 C 語言開發 MySQL 客戶端應用，核心在於掌握 libmysqlclient C API 的標準化流程：初始化 → 連線 → 執行 SQL → 處理結果集 → 清理資源。本文系統梳理關鍵 API、編譯鏈接參數、錯誤處理模式與完整可編譯範例。

核心 API 流程與關鍵函數

編譯鏈接實戰

方法一：pkg-config / mysql_config (推薦，跨平台)

gcc -o mysql_app mysql_app.c $(mysql_config --cflags --libs)
# 等價展開：
# -I/usr/include/mysql -L/usr/lib/mysql -lmysqlclient -lz -lcrypt -lpthread -lm -lssl -lcrypto

mysql_config 選項：
--cflags 編譯標頭路徑與宏
--libs 鏈接庫路徑與庫列表
--libs_r 執行緒安全版庫

方法二：手動指定 (舊系統/交叉編譯)

gcc -o mysql_app mysql_app.c \
    -I/usr/include/mysql \
    -L/usr/lib/mysql \
    -lmysqlclient -lz -lm -lpthread

⚠️ 庫順序敏感：-lmysqlclient 必須在 -lz -lm ... 之前。

完整可編譯範例：查詢用戶表

#include 
#include 
#include 
#include 

#define DB_HOST "localhost"
#define DB_USER "app_user"
#define DB_PASS "StrongP@ss"
#define DB_NAME "mydb"

void check_error(MYSQL *conn, const char *stage) {
    if (mysql_errno(conn)) {
        fprintf(stderr, "[%s] Error %d: %s\n", stage, mysql_errno(conn), mysql_error(conn));
        mysql_close(conn);
        exit(EXIT_FAILURE);
    }
}

int main() {
    MYSQL *conn = mysql_init(NULL);
    if (!conn) { fprintf(stderr, "mysql_init failed\n"); return 1; }

    // 連線
    if (!mysql_real_connect(conn, DB_HOST, DB_USER, DB_PASS, DB_NAME, 0, NULL, 0)) {
        check_error(conn, "connect");
    }
    printf("Connected to MySQL %s\n", mysql_get_server_info(conn));

    // 設定字元集
    if (mysql_set_character_set(conn, "utf8mb4")) {
        check_error(conn, "charset");
    }

    // 執行查詢
    const char *sql = "SELECT id, username, email FROM users WHERE status=1 LIMIT 10";
    if (mysql_query(conn, sql)) check_error(conn, "query");

    // 處理結果集
    MYSQL_RES *res = mysql_store_result(conn);
    if (!res) check_error(conn, "store_result");

    unsigned int num_fields = mysql_num_fields(res);
    MYSQL_FIELD *fields = mysql_fetch_fields(res);
    for (unsigned int i=0; i