解決 ODBC 自動配置資料來源失敗的問題

問題描述

嘗試透過程式碼或安裝腳本自動配置 ODBC 資料來源 (DSN) 時失敗，最終只能改用手動方式在「ODBC 資料來源管理員」中逐步設定。這在部署自動化流程中造成阻礙。

根本原因分析

最常見的原因是架構不匹配：應用程式為 32 位元，但系統安裝的 ODBC 驅動程式為 64 位元（或反之）。Windows 將 32 位元與 64 位元的 ODBC 管理員完全隔離：

• C:\Windows\System32\odbcad32.exe：64 位元管理員
• C:\Windows\SysWOW64\odbcad32.exe：32 位元管理員

若你的應用程式以 32 位元模式運行（預設 Visual Studio 專案常勾選 "Prefer 32-bit"），它只能看見 32 位元的 DSN 與驅動。若系統僅安裝 64 位元驅動，自動配置便會找不到驅動而失敗。

解決方案

1. 安裝對應位元的驅動程式：針對 32 位元應用程式，務必安裝 32 位元版本的資料庫 ODBC 驅動（例如：Microsoft Access Database Engine 2010/2016 Redistributable 的 32 位元版）。
2. 重新安裝/修復驅動：若驅動已損毀或註冊表遺失，重新安裝 32 位元驅動通常能修復自動配置功能。
3. 驗證驅動是否可見：執行 C:\Windows\SysWOW64\odbcad32.exe，切換到「驅動程式」索引標籤，確認目標驅動出現在清單中。

補充建議

• 使用 OdbcConnectionStringBuilder 建立連線字串，避免手工拼接錯誤。
• 若使用安裝專案，確保自訂動作以正確權限執行，並針對目標平台 (x86/x64) 打包正確的驅動安裝檔。

總結

ODBC 自動配置失敗九成以上是「32/64 位元驅動不匹配」。補裝對應位元的驅動程式後，問題通常即可解決。