C++ 連接 Access 數據庫「不是有效路徑」錯誤的排查與修復

使用 SQLConfigDataSource 配置 Access ODBC 數據源時，換電腦運行報「不是有效的路徑」，經典的部署環境差異問題。

錯誤代碼片段

SQLConfigDataSource(NULL, ODBC_ADD_DSN,
    "Microsoft Access Driver (*.mdb)",
    "DSN=Xus\0"
    "Description=Hotel\0"
    "FileType=Access\0"
    "DBQ=data\Xus.mdb, CDatabase::noOdbcDialog"); // 相對路徑

三大核心原因及對策

1. 相對路徑在不同工作目錄下失效

DBQ=data\Xus.mdb 依賴進程的「當前工作目錄」。雙擊啟動、命令行啟動、服務啟動、快捷方式啟動，工作目錄可能完全不同。

修復：改用絕對路徑，或從配置文件/註冊表/命令行參數讀取數據庫絕對路徑拼接。

// 獲取 exe 所在目錄拼接
CString exePath = GetModulePath(); // 需自行實現
CString dbPath = exePath + _T("\\data\\Xus.mdb");

2. 靜態/動態 MFC 庫選擇導致運行時依賴缺失

• 靜態鏈接 MFC：體積大，但無需部署 MFC DLL，適合簡單部署。
• 動態鏈接 MFC：體積小，目標機必須安裝對應版本 VC++ Redistributable 且 MFCxx.dll 在 PATH 中。

報錯「其它電腦無法運行」多半是動態鏈接但未安裝運行庫。建議發布版改用靜態鏈接 MFC，或製作安裝包自動安裝 VC++ 運行庫。

3. ODBC 驅動程序版本/位數不匹配

• 32 位程序需 32 位 Access 驅動（Microsoft Access Driver (*.mdb)）；64 位程序需 64 位驅動（Microsoft Access Driver (*.mdb, *.accdb)）。
• 目標機未安裝 Access 或 Access Database Engine，驅動不存在。

修復：安裝 Microsoft Access Database Engine（選對 x86/x64）。

最佳實踐清單

1. DBQ 一律用絕對路徑。
2. 發布版採用靜態 MFC，避免運行庫依賴。
3. 安裝包檢測並自動安裝 Access Database Engine。
4. 考慮遷移至 SQLite / SQL Server LocalDB，免驅動、免配置、跨平台更易。