GeoTools 導入 SHP 到 Oracle 表名含下劃線失敗問題：ojdbc6 驅動版本不匹配根因與修復

現象

使用 GeoTools DataStore.getFeatureWriterAppend(tableName, Transaction.AUTO_COMMIT) 寫入 Oracle，表名帶下劃線 (如 GIS_ROADS) 時報錯，純字母表名正常。

排查定位

1. 錯誤堆棟指向 JDBC 驅動元數據查詢階段。
2. Maven 依賴樹發現項目引用 ojdbc:ojdbc:14 (Oracle 10g 時代產物)。
3. Oracle 11g/12c/19c 官方推薦 ojdbc6.jar (JDK 6/7/8) 或 ojdbc8.jar (JDK 8+)。

根因

舊版 ojdbc14.jar 對 Oracle 11g+ 的標識符引用規則支持不全：表名含下劃線、大小寫混合、超過 30 字符等標識符在元數據查詢、PreparedStatement 綁定時解析異常，導致 GeoTools 通用寫入路徑失敗。

修復：升級驅動坐標

<!-- 移除舊坐標 -->
<dependency>
  <groupId>ojdbc</groupId>
  <artifactId>ojdbc</artifactId>
  <version>14</version>
</dependency>

<!-- 引入 Oracle 官方 Maven 坐標 (需配置 Oracle Maven 存儲庫或手動安裝) -->
<dependency>
  <groupId>com.oracle.database.jdbc</groupId>
  <artifactId>ojdbc8</artifactId>
  <version>19.3.0.0</version>
</dependency>

<!-- 或使用第三方鏡像坐標 (如中央庫可用) -->
<dependency>
  <groupId>cn.guoyukun.jdbc</groupId>
  <artifactId>oracle-ojdbc6</artifactId>
  <version>11.2.0.3.0</version>
</dependency>

驗證

1. mvn dependency:tree 確認無 ojdbc:ojdbc:14 殘留。
2. 重新運行導入任務，表名 GIS_ROADS、USER_DATA_2023 等均成功寫入。

擴展：GeoTools Oracle 數據存儲最佳實踐

• 使用 OracleNGDataStoreFactory (GeoTools 20+)，支援空間索引、SRID 自動處理。
• 連接池配置 HikariCP，參數 maxPoolSize=20、connectionTimeout=30s。
• 批量寫入開啟 Transaction.AUTO_COMMIT 並定期 commit()，避免大事務鎖表。
• SHP 編碼指定 Charset.forName("GBK") (中文屬性字段常見)。

總結

**驅動版本匹配數據庫版本是 JDBC 穩定性的基石**。舊驅動在新庫上可能運行但暗藏元數據解析、標識符轉義、類型映射等隱患。定期對齊 ojdbc6/8 版本與 Oracle 數據庫版本，納入依賴升級例行檢查清單。