Delphi 連接 MySQL 完整實戰：dbExpress 架構、組件配置、連接池與部署依賴

架構概覽

使用 **dbExpress** 四層架構連接 MySQL：

UI 控件 (DBGrid, DBNavigator)
    ↓
DataSource (TDataSource)
    ↓
ClientDataSet (TClientDataSet) ← 內存數據緩存、支持離線編輯
    ↓
DataSetProvider (TDataSetProvider) ← 適配器，橋接雙向數據流
    ↓
SQLTable / SQLQuery (TSQLTable/TSQLQuery) ← 一向游標、只讀/可更新
    ↓
SQLConnection (TSQLConnection) ← dbExpress 驅動層
    ↓
MySQL 客戶端庫 (libmysql.dll) + dbExpress 驅動

核心組件配置詳解

1. SQLConnection (關鍵)

ConnectionName = 'MYSQLCONNECTION'
DriverName = 'MySQL'
GetDriverFunc = 'getSQLDriverMYSQL'
LibraryName = 'dbxmys.dll'        -- dbExpress MySQL 驅動
VendorLib = 'libmysql.dll'        -- MySQL 官方客戶端庫
LoginPrompt = False
Params.Values['HostName'] = 'localhost'
Params.Values['Database'] = 'mysqldb'
Params.Values['User_Name'] = 'root'
Params.Values['Password'] = 'pswd'
Params.Values['MaxBlobSize'] = '-1'
Params.Values['ServerCharSet'] = 'utf8'
Connected = True

2. SQLTable / SQLQuery

• `TSQLTable`：綁定單表，`TableName = 'human'`，適合簡單 CRUD。
• `TSQLQuery`：執行任意 SQL，支持參數化查詢，**生產環境首選**。

3. ClientDataSet 關鍵屬性

Active = True
ProviderName = 'DataSetProvider1'
-- 重要事件：
-- OnReconcileError: 衝突解決 (ApplyUpdates 失敗時)
-- BeforePost: 客戶端驗證

更新持久化代碼

procedure TForm1.Button1Click(Sender: TObject);
begin
  // 將 ClientDataSet 內存修改批量應用到數據庫
  ClientDataSet1.ApplyUpdates(0); // 0 = 無限重試
end;

部署依賴：兩個核心 DLL 必須隨程序發布

1. dbxmys.dll：dbExpress MySQL 驅動 (位於 Delphi 安裝目錄 `Bin` 或 `dbExpress` 目錄)。
2. libmysql.dll：MySQL 官方客戶端庫，**版本必須與目標 MySQL 服務器兼容** (建議用 5.7/8.0 官方發布包中的 dll)。

放置於應用程序同目錄或系統 PATH 目錄下。

常見問題排查