如何在gradlew installDist时配置java.library.path解决JNI库加载错误

API 探路者

2026-9-26

JNI加载原生库报错问题解决方案

错误原因

你遇到的`UnsatisfiedLinkError`是因为JVM执行`System.loadLibrary("native")`时，会从`java.library.path`系统属性指定的路径下查找名为`libnative.so`的库文件。虽然`installDist`已经将`libnative.so`打包到了构建产物的`lib`目录下，但默认生成的启动脚本没有将该`lib`目录添加到`java.library.path`的搜索路径中，因此JVM找不到对应原生库。

解决方案

直接修改build.gradle中application插件的配置，让生成的启动脚本自动将产物的lib目录添加到JVM启动参数的java.library.path中即可：

plugins {
    id 'application'
}

group 'org.example'
version '1.0-SNAPSHOT'

repositories {
    mavenCentral()
}

application {
    mainClass = 'zxy.JNIDemo'
    // 新增配置：启动时自动将APP_HOME下的lib目录加入java.library.path
    // 注意$需要转义，保证APP_HOME变量会被启动脚本正确解析
    applicationDefaultJvmArgs = ['-Djava.library.path=\${APP_HOME}/lib']
}

dependencies {
    testCompile group: 'junit', name: 'junit', version: '4.12'
    implementation files('libs/libnative.so')
}

// 可选配置：本地执行gradlew run时也能正确找到原生库
tasks.named('run') {
    systemProperty 'java.library.path', file('libs').absolutePath
}