Python 安裝 MySQL 支援模組完整指南：常見錯誤與解決方案

前言

在 Python 專案中連接 MySQL 資料庫時，通常需要安裝 MySQLdb（即 mysql-python）模組。然而，安裝過程常因環境配置問題而報錯。本文記錄從下載、編譯到執行的完整流程，並針對常見錯誤提供解決方案，供開發者參考。

1. 下載 MySQL-Python 支援庫

官方專案託管於 SourceForge，下載地址：
https://sourceforge.net/projects/mysql-python/

下載對應作業系統與 Python 版本的原始碼壓縮包（如 mysql-python-1.2.5.zip）。

2. 解壓與編譯安裝

解壓後進入目錄，執行標準安裝命令：

python setup.py install

3. 常見錯誤與解決方案

錯誤一：找不到 my_config.h

_mysql.c:44:23: error: my_config.h: No such file or directory

原因：編譯器無法定位 MySQL 的開發頭文件。

解決：編輯 setup_posix.py，將 mysql_config.path 指向實際安裝的 mysql_config 執行檔路徑，例如：

mysql_config.path = "/usr/local/mysql/bin/mysql_config"

修改後重新執行 python setup.py install。

錯誤二：動態連結庫載入失敗

ImportError: libmysqlclient_r.so.16: cannot open shared object file: No such file or directory

原因：系統動態連結器找不到 MySQL 的客戶端庫文件。

解決：編輯 /etc/ld.so.conf.d/mysql-i386.conf（或對應的配置文件），加入 MySQL 庫目錄路徑，例如：

/usr/local/mysql/lib/mysql

保存後執行 ldconfig 刷新快取：

ldconfig

4. 驗證安裝

進入 Python 互動環境，嘗試匯入模組：

>> import MySQLdb
>>> print(MySQLdb.__version__)

若無報錯並顯示版本號，即表示安裝成功。

總結

安裝 mysql-python 的關鍵在於正確指定 MySQL 開發庫路徑與動態連結庫路徑。遇到錯誤時，優先檢查 mysql_config 路徑與 ldconfig 配置。建議在虛擬環境中操作，避免污染系統環境。