OCCI 開發常見問題：ORA-32104 環境不匹配與 VS 調試異常

問題 1：Environment::createEnvironment() 拋出 ORA-32104

現象：程式啟動時建立 OCCI 環境失敗，錯誤碼 ORA-32104 無詳細訊息。

根因：編譯時連結的 OCCI 函式庫版本與執行時載入的 Oracle Client 版本不一致。典型案例：開發機安裝 10g Client，但專案連結 11g OCCI SDK。

解決步驟

1. 統一版本：確保編譯、連結、執行三階段使用同一版本的 Instant Client (Basic + SDK)。
2. 環境變數 PATH 順序：將目標版本 instantclient_11_2 目錄置於 PATH 最前端，優先於舊版 Client 路徑。
3. DLL 覆蓋：將 occivc9win32-111060-132181 (OCCI VC9 版本) 下的 oraocci11.dll 等複製覆蓋至 instantclient_11_2 目錄，確保載入的是匹配版本。

依賴關係圖解

編譯階段：instantclient-sdk-nt-11.2.0.4.0  →  .h 標頭檔
連結階段：occivc9win32-111060-132181      →  .lib 匯入庫
執行階段：occivc9win32-111060-132181      →  oraocci11.dll (OCCI 核心)
           instantclient_11_2                →  oci.dll + 其它 Client 共享庫

問題 2：VS 偵錯模式下報錯，直接執行 EXE 正常

現象：Visual Studio 按 F5 啟動偵錯時彈出錯誤對話框，但雙擊 EXE 直接執行完全正常。

可能原因：

• VS 偵錯器啟動進程時的工作目錄、環境變數、DLL 搜尋順序與直接執行不同。
• 偵錯堆 (Debug Heap) 行為差異觸發 OCCI 內部檢查。
• 專案屬性 Debugging → Environment / Working Directory 設定缺失 PATH 或 ORACLE_HOME。

排查建議

1. 在專案屬性 Debugging → Environment 加入 PATH=...instantclient_11_2;%PATH%。
2. 設定 Working Directory 為 EXE 所在目錄。
3. 嘗試 Attach to Process 方式：先直接執行 EXE，再從 VS Debug → Attach to Process 掛上去。
4. 檢查 _NO_DEBUG_HEAP=1 環境變數禁用偵錯堆。

最佳實踐檢查清單

1. 專案僅保留單一版本 Instant Client 依賴，移除舊版 Oracle Client 路徑。
2. 使用 CMake / vcxproj 透過 find_package(OCI) 統一管理包含目錄、庫目錄、連結庫。
3. 部署時將 instantclient_11_2 整個目錄隨應用程式打包 (綠色部署)，避免系統級 Client 衝突。
4. 啟用 OCCI 追蹤 (oraocci11.trc) 診斷疑難雜症：set ORA_OCCI_TRACE_LEVEL=1。