ADO 訪問 Access 數據庫常見錯誤排查與解決方案

錯誤現象

近期在使用 ADO 連接 Access 數據庫時遇到一個詭異錯誤，經排查記錄如下，供參考。

關鍵代碼片段

數據庫操作類

// 伪代碼示例
_ConnectionPtr pConn;
_RecordsetPtr pRs;
pConn.CreateInstance(__uuidof(Connection));
pConn->Open("Provider=Microsoft.Jet.OLEDB.4.0;Data Source=test.mdb", "", "", adModeUnknown);
pRs = pConn->Execute("SELECT * FROM Users", NULL, adCmdText);

調用代碼

// 業務邏輯中調用
CString strSql = "INSERT INTO Users(Name) VALUES('Test')";
pConn->Execute(_bstr_t(strSql), NULL, adCmdText);

錯誤分析

• 錯誤碼：0x80040E14（語法錯誤）或 0x80004005（未指定錯誤）
• 現象：SQL 語句在 Access 自帶查詢器中可正常執行，但 ADO 執行失敗。

解決方案

1. 檢查保留字衝突：Access 將 Name、Date、Key 等視為保留字，需用方括號包裹：[Name]。
2. 參數化查詢：避免字符串拼接導致的注入與格式問題，使用 Command + Parameter。
3. 連接字符串版本：Access 2007+ (.accdb) 需用 Microsoft.ACE.OLEDB.12.0；舊版 .mdb 用 Microsoft.Jet.OLEDB.4.0。
4. 權限與路徑：確保進程對數據庫文件有讀寫權限，路徑無中文/特殊字符。

總結

ADO 操作 Access 時，保留字轉義與提供者版本匹配是兩大高頻坑點。建議統一使用參數化命令，並根據文件後綴動態選擇 Provider。