GraalVM构建Windows原生应用运行找不到pkcs11wrapper库报UnsatisfiedLinkError

• 你在native-image构建命令中传入的-Djava.library.path是构建阶段的JVM参数，不会被固化到生成的exe可执行文件中，原生镜像运行时不会读取该构建时配置。
• GraalVM原生镜像的原生库加载逻辑与标准JVM不同，默认运行时的java.library.path仅读取Windows系统环境变量Path的内容，或运行时手动传入的参数配置。
• 未提前配置JNI访问规则，导致原生镜像识别不到你要加载的pkcs11wrapper库。

快速验证方案（运行时传参） #

运行生成的exe时手动传入library path参数即可，命令示例：

NativeCpsApplication.exe -Djava.library.path=C:\dev\

如果运行正常，说明你的dll文件本身没有版本、架构不匹配的问题，仅为参数传递问题。

无需额外传参的解决方案 #

方案1：配置系统环境变量 #

将C:\dev\路径添加到Windows系统环境变量Path中，修改完成后重启终端/资源管理器生效，后续直接双击运行exe即可正常加载dll。

方案2：将dll打包进原生镜像（单exe分发） #

如果希望生成的exe无需依赖外部dll文件，修改你的native-image构建命令，添加对应参数：

native-image -cp target\single-proxy-native-0.0.1-SNAPSHOT.jar;C:\dev\tools\m2\iaik\pkcs\pkcs11-wrapper\1.4\pkcs11-wrapper-1.4.jar ^
-H:JNI=fr.devboxsante.cps.nativ.NativeCpsApplication ^
-H:NativeLibraries=C:\dev\pkcs11wrapper.dll ^
-H:+LoadNativeLibrariesAtBuildTime ^
fr.devboxsante.cps.nativ.NativeCpsApplication

该命令会将dll直接编译进原生镜像，运行时无需额外携带dll文件，也不需要配置环境变量。

• 确认你使用的pkcs11wrapper.dll版本与pkcs11-wrapper-1.4.jar版本完全匹配，且架构与你的GraalVM架构一致（同为64位或32位）。
• 可在代码中添加一行System.out.println(System.getProperty("java.library.path"))，运行原生镜像时打印实际生效的库路径，确认配置是否生效。

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