Java 調用 GDAL 原生庫（DLL/so）完整配置指南

GDAL（Geospatial Data Abstraction Library）是地理空間數據處理的標準庫，Java 通過 JNI 綁定 gdaljni 調用其 C++ 核心。本文記錄 Windows 下 DLL 配置與驗證流程。

步驟總覽

1. 編譯 GDAL 源碼（或下載預編譯二進制），產出 gdaljni.dll、gdal_allRegister.dll 等。
2. 將所有 DLL 複製到 {JAVA_HOME}\jre\bin（或系統 PATH 目錄）。
3. 將 gdal.jar 加入 Java 項目 classpath。
4. 代碼中載入庫並驗證可用性。

關鍵配置截圖

驗證代碼

@Override
protected boolean doIsAvailable() throws Throwable {
    System.loadLibrary("gdaljni"); // 載入 gdaljni.dll
    return true; // 載入成功即可用
}

常見坑與排查

• UnsatisfiedLinkError: Can't find dependent libraries：缺少 GDAL 依賴的第三方 DLL（如 geotiff.dll, hdf5.dll）。需將完整 GDAL bin 目錄加入 PATH。
• 32/64 位不匹配：JDK、GDAL DLL、操作系統位數必須一致（均為 64 位）。
• Linux/macOS：將 .so 放入 /usr/lib 或 LD_LIBRARY_PATH，載入名稱去掉前綴「lib」與後綴「.so」：System.loadLibrary("gdaljni")。

Maven 依賴（若使用官方發布）

<dependency>
  <groupId>org.gdal</groupId>
  <artifactId>gdal</artifactId>
  <version>3.8.0</version>
</dependency>

注意：Maven Central 的 gdal jar 通常不包含原生庫，仍需手動部署 DLL/so。