Windows环境下HEC-HMS运行Jython脚本GDAL原生库加载失败问题

报错核心逻辑：提示gdalalljni.dll找不到依赖库，本质是Windows系统加载该原生DLL时，未找到其关联的基础依赖文件，和前期配置的GDAL配置类环境变量无直接关联，前期配置的路径存在与实际安装目录错位的问题。 #

1. 修正环境变量的路径错位问题 #

你当前配置的所有GDAL相关环境变量，均指向C:/Programs/HEC-HMS-4.8/目录，但HEC-HMS 4.8的实际安装路径为C:\Program Files\HEC\HEC-HMS\4.8，路径指向完全无效，需对照实际安装目录修正配置：

• GDAL_DATA：修改为C:\Program Files\HEC\HEC-HMS\4.8\gdal-data
• GDAL_DRIVER_PATH：修改为C:\Program Files\HEC\HEC-HMS\4.8\bin\gdal\gdalplugins
• PROJ_LIB：修改为C:\Program Files\HEC\HEC-HMS\4.8\projlib

2. 解决DLL依赖缺失的根本问题 #

Java虚拟机启动参数中指定的java.library.path仅用于定位JNI入口DLL本身，Windows系统查找DLL关联依赖的顺序不受Java配置控制，系统会按固定顺序检索：当前工作目录、系统目录、PATH环境变量条目对应的目录，检索不到依赖文件就会抛出UnsatisfiedLinkError。
对应操作：

• 打开系统环境变量的Path列表，将HEC-HMS安装目录下的三个原生库路径添加到列表最前端：
  • C:\Program Files\HEC\HEC-HMS\4.8\bin
  • C:\Program Files\HEC\HEC-HMS\4.8\bin\gdal
  • C:\Program Files\HEC\HEC-HMS\4.8\bin\hdf
• 安装匹配系统架构（x64）的微软Visual C++可再发行组件包，绝大多数同类gdalalljni.dll加载失败，根源是缺少GDAL编译时依赖的VC运行库，并非软件自带的GDAL文件损坏。
• 禁止下载第三方独立GDAL安装包替换软件自带的库文件，会出现版本不兼容导致的连锁报错。

3. 校验批处理运行的前置条件 #

• 执行批处理命令前，先将命令行的工作目录切换到HEC-HMS的实际安装根目录，避免脚本内置的相对路径（如.\hms.jar、.\bin\*）解析失败。
• 核对命令传入的脚本路径与实际加载的脚本路径一致：你执行命令时传入的路径为C:/Projects/castro/scripts/compute_current.py，但日志显示实际加载的是c:\Users\windar\Documents\castro_48.py，需修正路径参数避免脚本解析异常。
• 确保当前运行命令的用户账号，对C:\Program Files\HEC\HEC-HMS\4.8目录有完整的读取权限，避免系统拦截原生库的加载流程。

内容的提问来源于stack exchange，提问作者orangepixel