JDBC 連線 Teradata 缺少 JAR 包錯誤解決

嘗試使用 JDBC 直連 Teradata 時，遇到 GSSException: Failure unspecified at GSS-API level (Mechanism level: UserFile parameter null) 錯誤，堆疊追蹤指向 TdgssConfigApi、TdgssManager 等安全模組初始化失敗。

根因分析

Teradata JDBC 驅動採用模組化設計，必須同時提供三個 JAR 包，缺一不可：

1. terajdbc4.jar - 核心 JDBC 驅動
2. tdgssjava.jar - GSS 安全機制 Java 實現
3. tdgssconfig.jar - 安全配置解析器

錯誤發生原因：僅引入了 terajdbc4.jar，導致安全子系統初始化時找不到配置解析器（TdgssParseXml），拋出 UserFile parameter null。

解決方案

將三個 JAR 全部加入專案類別路徑：

• Maven 專案：在 pom.xml 添加三個依賴（需配置 Teradata 私有倉庫）
• 傳統專案：手動複製三個 JAR 至 WEB-INF/lib 或建構路徑

設計評論

Teradata 將 JDBC 依賴拆分為三個獨立包，雖符合模組化原則，但對初學者極不友好。建議官方提供整合包或在文檔中更醒目標註依賴關係，減少「缺包」排查成本。