MySQL 客戶端庫鏈結錯誤完整排查：undefined reference、執行期載入失敗與跨平台編譯實戰

編譯期錯誤：undefined reference to `mysql_xxx`

原因

鏈結器找不到 libmysqlclient 符號。

解決

# 1. 獲取正確編譯/鏈結參數
mysql_config --cflags --libs
# 輸出範例：-I/usr/include/mysql -L/usr/lib64/mysql -lmysqlclient -lz -lcrypt -lssl -lcrypto

# 2. 編譯命令範例
gcc -o myapp myapp.c $(mysql_config --cflags --libs)

# 3. 手動指定 (若無 mysql_config)
gcc -o myapp myapp.c -I/usr/include/mysql -L/usr/lib64/mysql -lmysqlclient -lz

常見缺失庫補充

執行期錯誤：libmysqlclient.so not found

原因

動態連結器在標準路徑找不到共享庫。

四種修正方式

1. LD_LIBRARY_PATH (臨時)：
   export LD_LIBRARY_PATH=/usr/lib64/mysql:$LD_LIBRARY_PATH
2. /etc/ld.so.conf.d/mysql.conf (永久，需 root)：
   echo "/usr/lib64/mysql" > /etc/ld.so.conf.d/mysql.conf && ldconfig
3. 複製至系統路徑：
   cp /usr/lib64/mysql/libmysqlclient.so* /usr/lib/ && ldconfig
4. 靜態鏈結 (避免部署依賴)：
   gcc -static -o myapp myapp.c $(mysql_config --cflags --libs)
   注意：靜態鏈結 glibc 需 glibc-static 套件，且失去動態升級優勢。

跨平台編譯避坑

• Windows (MinGW/MSVC)：使用 libmysql.lib (MSVC) 或 libmysql.dll.a (MinGW)，標頭檔 mysql.h。
• 交叉編譯：./configure --host=arm-linux-gnueabihf --with-mysql=/path/to/arm/mysql。
• 多版本共存：mysql_config --version 確認版本，update-alternatives 管理預設。

CMake 現代專案整合

find_package(MySQL REQUIRED)
target_link_libraries(myapp PRIVATE MySQL::mysqlclient)

結語

鏈結錯誤本質是頭檔/庫路徑、依賴庫順序、執行期載入路徑三者不一致。標準化流程：以 mysql_config / pkg-config / CMake 為單一真實來源，消除手動參數差異，確保開發/測試/生產環境一致性。