1. Delphi 零基礎(chǔ)用 FireDAC 連 MySQL 到底難在哪如果你剛開始用 Delphi 寫點(diǎn)小工具大概率會遇到這個場景界面拖完了按鈕也擺好了結(jié)果一到連數(shù)據(jù)庫就卡住。報錯五花八門Cannot load vendor library、Unknown MySQL server host、中文變問號隨便一個都能耗掉一下午。我當(dāng)初也是從拖組件開始的覺得可視化最省事但 FireDAC 連 MySQL 這件事光靠拖組件還不夠得把驅(qū)動、參數(shù)、字符集這幾塊理清楚。FireDAC 是 Delphi 自帶的一套數(shù)據(jù)訪問框架它能連 MySQL、SQL Server、SQLite、Oracle 等一堆數(shù)據(jù)庫。對 Delphi 零基礎(chǔ)的人來說它的好處是組件化程度高TFDConnection、TFDQuery、TDataSource、TDBGrid拖一拖就能出結(jié)果。但它的坑也很集中MySQL 驅(qū)動不是 Delphi 自帶的你得自己準(zhǔn)備libmysql.dll連接參數(shù)寫錯一個字母就連不上字符集不指定中文直接亂碼。這篇要解決的就是這條完整路徑從驅(qū)動選型、組件擺放、參數(shù)配置到查詢驗證和增刪改查跑通。同時我會把多環(huán)境憑據(jù)管理這件事一起說清楚——你本地開發(fā)、測試庫、線上庫如果各寫一套賬號密碼改起來很容易漏。用 TaoToken 的統(tǒng)一 Key 和 API 通道來管理這些憑據(jù)可以讓配置更干凈切換環(huán)境時不用滿項目找密碼。適合誰看剛接觸 Delphi、想用 FireDAC 連 MySQL 做個小工具或課程作業(yè)的人已經(jīng)能連上但總被字符集或驅(qū)動路徑坑的人以及想把數(shù)據(jù)庫憑據(jù)從代碼里抽出來、統(tǒng)一管理的人。下面按可復(fù)制的步驟來每一步都給完整代碼和參數(shù)你照著改改就能跑。2. TaoToken 統(tǒng)一 Key 與 API 通道的前置準(zhǔn)備在正式寫 FireDAC 連接之前先把憑據(jù)管理這塊理順。很多人寫小工具的習(xí)慣是直接把數(shù)據(jù)庫賬號密碼硬編碼在FormCreate里本地跑沒問題但一旦要換庫、換機(jī)器、或者把代碼發(fā)給別人就得手動改。更麻煩的是如果你同時用多個環(huán)境密碼散落在不同單元里排查起來很痛苦。TaoToken 在這里的角色是統(tǒng)一 Key 和 API 通道管理。你可以把它理解成一個憑據(jù)中轉(zhuǎn)層數(shù)據(jù)庫連接信息、模型調(diào)用 Key、不同環(huán)境的配置都通過統(tǒng)一的 Key 來引用而不是散落在代碼各處。對 Delphi 項目來說最直接的好處是TFDConnection.Params里的User_Name、Password、Server這些值可以從統(tǒng)一配置讀取切換環(huán)境時只改一處。具體操作上先到官網(wǎng) https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 注冊并登錄然后在控制臺里創(chuàng)建你的 API Key?？刂婆_地址是 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite 進(jìn)去之后找到 API Keys 頁面新建一個 Key 并復(fù)制保存。這個 Key 就是你后續(xù)調(diào)用統(tǒng)一通道的憑證。如果你后面還要接模型對話或編碼輔助可以順便看下模型對話入口 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite 和 Coding Plan https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 。不過這篇的重點(diǎn)是數(shù)據(jù)庫連接所以 Key 拿到之后我們主要用它來管理數(shù)據(jù)庫憑據(jù)。這里要強(qiáng)調(diào)一點(diǎn)TaoToken 不是讓你把 MySQL 連接直接走它的 API而是用它來統(tǒng)一管理你的憑據(jù)和配置。FireDAC 連 MySQL 仍然是本機(jī)直連libmysql.dll和TFDPhysMySQLDriverLink該配還得配。TaoToken 解決的是“密碼寫在哪、怎么切換、怎么不泄露”的問題。你可以把數(shù)據(jù)庫連接串存成配置通過統(tǒng)一 Key 拉取代碼里只保留 Key 的引用。接入文檔在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 里面有完整的 Key 使用說明和 API 通道配置方式。API 基礎(chǔ)地址是 https://taotoken.net/api 注意這個地址不加 UTM 參數(shù)直接用于程序內(nèi)調(diào)用。API Keys 管理頁在 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 你可以在這里隨時輪換 Key。對 Delphi 零基礎(chǔ)的人來說這一步不用想太復(fù)雜先拿到 Key知道它放在哪后面配置TFDConnection時把敏感字段替換成從統(tǒng)一配置讀取就行。如果你暫時只想跑通本地連接也可以先硬編碼等跑通后再把憑據(jù)抽出來。但建議一開始就養(yǎng)成習(xí)慣不然后面改起來更麻煩。3. 可復(fù)制的 FireDAC 連接配置與組件參數(shù)模板這一節(jié)是核心直接給可復(fù)制的配置。先說組件清單在 Delphi 的 Tool Palette 里找到 FireDAC 頁簽拖這幾個到 Form 上TFDPhysMySQLDriverLink、TFDGUIxWaitCursor、TFDConnection、TFDQuery、TDataSource、TDBGrid。再放一個TButton用來觸發(fā)查詢。TFDGUIxWaitCursor不用改屬性它負(fù)責(zé) SQL 執(zhí)行時的等待光標(biāo)。TFDPhysMySQLDriverLink是關(guān)鍵它的VendorLib屬性要指向你本機(jī)libmysql.dll的完整路徑。這個 dll 不在 Delphi 安裝目錄里你需要單獨(dú)準(zhǔn)備。通常 MySQL 安裝目錄下的lib文件夾里有比如D:\MySQL\lib\libmysql.dll。如果沒有去 MySQL 官方下載對應(yīng)版本的 Connector/C解壓后找到libmysql.dll。注意位數(shù)要匹配你的 Delphi 編譯目標(biāo)是 32 位就放 32 位 dll64 位就放 64 位 dll混了會報Cannot load vendor library。TFDConnection的配置分兩部分。屬性面板里設(shè)DriverName為MySQLLoginPrompt設(shè)為False避免每次彈登錄框。重點(diǎn)是Params點(diǎn)進(jìn)去填這些DriverIDMySQL Server127.0.0.1 Port3306 Databaseyour_database User_Nameyour_user Passwordyour_password CharacterSetutf8mb4這里CharacterSet建議用utf8mb4比gb2312兼容性更好中文和 emoji 都不會亂。如果你用的是老版本 MySQL 且表是 gb2312那就按實際字符集填但新項目一律 utf8mb4。如果你想把配置寫成代碼在FormCreate里這樣寫procedure TForm1.FormCreate(Sender: TObject); begin FDConnection1.Close; FDConnection1.Params.Clear; FDConnection1.Params.Add(DriverIDMySQL); FDConnection1.Params.Add(Server127.0.0.1); FDConnection1.Params.Add(Port3306); FDConnection1.Params.Add(Databaseyour_database); FDConnection1.Params.Add(User_Nameyour_user); FDConnection1.Params.Add(Passwordyour_password); FDConnection1.Params.Add(CharacterSetutf8mb4); FDConnection1.Connected : True; end;如果你用 TaoToken 統(tǒng)一管理憑據(jù)可以把Server、User_Name、Password這些值從配置讀取代碼里只保留 Key 引用。比如用一個TIniFile或 JSON 配置文件存環(huán)境信息Key 存在環(huán)境變量里。這樣切換環(huán)境時只改配置文件不用動代碼。TFDQuery的Connection屬性指向FDConnection1TDataSource的DataSet指向FDQuery1TDBGrid的DataSource指向DataSource1。按鈕的OnClick里寫procedure TForm1.btnQueryClick(Sender: TObject); begin FDQuery1.Close; FDQuery1.SQL.Text : SELECT * FROM your_table; FDQuery1.Open; end;這樣點(diǎn)按鈕就能在TDBGrid里看到數(shù)據(jù)。增刪改查的寫法也類似INSERT、UPDATE、DELETE用ExecSQLSELECT用Open。注意ExecSQL之后如果要刷新顯示重新Open一次查詢即可。關(guān)于libmysql.dll的路徑建議放在項目輸出目錄和 exe 同級這樣VendorLib可以直接寫libmysql.dll不用寫絕對路徑換機(jī)器也能跑。如果放別處就寫完整路徑。這一步踩過的坑最多路徑錯、位數(shù)錯、dll 版本和 MySQL 服務(wù)端不匹配都會連不上。4. 三步連通性驗證與增刪改查成功結(jié)果配置寫完之后不要急著寫業(yè)務(wù)邏輯先做連通性驗證。分三步每步都有明確的成功標(biāo)志。第一步驗證驅(qū)動加載。在FormCreate里Connected : True之前先加一句FDPhysMySQLDriverLink1.VendorLib : libmysql.dll;然后運(yùn)行程序。如果驅(qū)動加載失敗會立刻報Cannot load vendor library [libmysql.dll]。成功的話不會有提示直接進(jìn)入下一步。如果報錯檢查 dll 是否在 exe 同級目錄、位數(shù)是否匹配。第二步驗證連接。Connected : True執(zhí)行后如果賬號密碼或庫名錯會報Access denied for user或Unknown database。成功的話FDConnection1.Connected為True你可以加一句ShowMessage(連接成功)確認(rèn)。這一步還要驗證字符集在TFDQuery里執(zhí)行SELECT 中文測試 AS t看TDBGrid里顯示是否正常。如果顯示問號說明CharacterSet沒生效檢查參數(shù)拼寫。第三步驗證增刪改查。建一張測試表CREATE TABLE test_user ( id INT AUTO_INCREMENT PRIMARY KEY, name VARCHAR(50), age INT ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;然后在 Delphi 里寫四個按鈕分別對應(yīng)增刪改查// 增 FDQuery1.SQL.Text : INSERT INTO test_user (name, age) VALUES (:name, :age); FDQuery1.ParamByName(name).AsString : 張三; FDQuery1.ParamByName(age).AsInteger : 25; FDQuery1.ExecSQL; // 查 FDQuery1.SQL.Text : SELECT * FROM test_user; FDQuery1.Open; // 改 FDQuery1.SQL.Text : UPDATE test_user SET age :age WHERE name :name; FDQuery1.ParamByName(age).AsInteger : 26; FDQuery1.ParamByName(name).AsString : 張三; FDQuery1.ExecSQL; // 刪 FDQuery1.SQL.Text : DELETE FROM test_user WHERE name :name; FDQuery1.ParamByName(name).AsString : 張三; FDQuery1.ExecSQL;每執(zhí)行一步重新Open查詢看TDBGrid結(jié)果。成功標(biāo)志插入后能查到新記錄更新后年齡變了刪除后記錄消失。如果ExecSQL報SQL command not properly ended檢查 SQL 語句有沒有多余分號如果參數(shù)報Parameter not found檢查ParamByName的名字和 SQL 里的占位符是否一致。實測下來這套流程跑通之后后面接任何業(yè)務(wù)表都是復(fù)制粘貼改表名。多環(huán)境切換時把TFDConnection.Params里的值換成從 TaoToken 統(tǒng)一配置讀取代碼不用動。比如本地用127.0.0.1測試庫用另一臺機(jī)器只改配置文件里的Server和Database即可。5. 本篇常見報錯排查對照這一節(jié)把最容易遇到的報錯列出來對照著查。Cannot load vendor library [libmysql.dll]驅(qū)動 dll 沒找到或位數(shù)不對。解決把libmysql.dll放到 exe 同級目錄確認(rèn) Delphi 編譯目標(biāo)位數(shù)和 dll 位數(shù)一致。32 位 Delphi 配 32 位 dll64 位配 64 位。Access denied for user rootlocalhost賬號密碼錯或者該用戶沒有從當(dāng)前主機(jī)連接的權(quán)限。解決檢查User_Name和Password確認(rèn) MySQL 里該用戶允許從127.0.0.1或localhost連接。Unknown database xxx庫名寫錯或庫不存在。解決在 MySQL 里SHOW DATABASES;確認(rèn)庫名注意大小寫。Unknown MySQL server host xxxServer參數(shù)寫錯或者本機(jī)沒啟動 MySQL 服務(wù)。解決確認(rèn)Server是127.0.0.1或?qū)嶋H IP檢查 MySQL 服務(wù)是否運(yùn)行。Client does not support authentication protocolMySQL 8 默認(rèn)認(rèn)證插件和舊版libmysql.dll不匹配。解決換新版 Connector/C 的 dll或者把用戶認(rèn)證方式改成mysql_native_password。中文亂碼顯示問號CharacterSet沒設(shè)或設(shè)錯。解決參數(shù)里加CharacterSetutf8mb4同時確認(rèn)表和字段的字符集也是 utf8mb4。SQL command not properly endedSQL 語句末尾多了分號或者語法不對。解決FireDAC 里SQL.Text不要帶末尾分號。Parameter xxx not foundParamByName的名字和 SQL 占位符不一致。解決統(tǒng)一用:name格式檢查拼寫。Connection is not open在Connected : False或未連接時執(zhí)行了查詢。解決先FDConnection1.Connected : True;再操作TFDQuery。OAuth或local proxy failed這類報錯如果你在用統(tǒng)一 Key 通道調(diào)用模型或 API 時遇到檢查 Key 是否有效、API 基礎(chǔ)地址是否為 https://taotoken.net/api 。API Keys 頁面 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 可以重新生成 Key。接入文檔 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 里有完整的錯誤碼說明。reading choices報錯通常出現(xiàn)在模型調(diào)用返回解析時檢查請求體格式和模型 ID 是否正確。如果你在 Delphi 里用TNetHTTPClient調(diào) API確認(rèn) JSON 字段名和文檔一致。排查順序建議先看驅(qū)動再看連接再看 SQL最后看字符集。大部分問題集中在前兩步。把TFDConnection的Connected設(shè)為True時如果沒報錯說明驅(qū)動和連接都通了剩下的就是 SQL 和字符集問題。6. 多環(huán)境憑據(jù)管理與后續(xù)接入建議跑通單機(jī)連接之后下一步就是把憑據(jù)管理規(guī)范化。Delphi 項目里常見的做法是用TIniFile或 JSON 配置文件存環(huán)境信息代碼里讀配置。但配置文件本身如果明文存密碼也有泄露風(fēng)險。這時候用 TaoToken 的統(tǒng)一 Key 來管理就更合適配置文件里只存 Key 的引用實際憑據(jù)通過 API 通道拉取。具體做法在 TaoToken 控制臺創(chuàng)建不同環(huán)境的配置每個環(huán)境對應(yīng)一組數(shù)據(jù)庫連接信息。Delphi 程序啟動時用統(tǒng)一 Key 調(diào)用 API 獲取當(dāng)前環(huán)境的配置然后填充TFDConnection.Params。這樣切換環(huán)境只需要改一個環(huán)境變量或配置項不用改代碼也不用把密碼寫死在 exe 里。如果你后面還要接模型對話或編碼輔助模型對話入口在 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite Coding Plan 在 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 。Claude Code 相關(guān)接入看 https://taotoken.net/claude-code?utm_sourcetaotoken_aicg_blog_endutm_contentclaude-codeutm_campaignrewrite 。這些通道和數(shù)據(jù)庫憑據(jù)管理可以共用同一套 Key 體系維護(hù)起來更省心。對 Delphi 零基礎(chǔ)的人來說不用一上來就搞全套。先把 FireDAC 連 MySQL 跑通能查能改再逐步把憑據(jù)抽出來。抽的時候注意TFDConnection.Params里的Password不要出現(xiàn)在日志或異常信息里TFDPhysMySQLDriverLink.VendorLib的路徑盡量用相對路徑libmysql.dll跟著 exe 走不要依賴系統(tǒng)目錄。最后給一個實用技巧在FormClose里加FDConnection1.Connected : False;避免程序退出時連接沒釋放。如果頻繁開關(guān)連接影響性能可以用TFDConnection的連接池但小工具一般不需要。增刪改查跑通之后把 SQL 語句抽到常量或資源文件里代碼會干凈很多。