java jni开发，System.loadLibraryt()和System.load()区别是什么？

在 Java JNI 开发里，System.loadLibrary() 和 System.load() 是两套完全不同的加载逻辑，这块在你这种 容器 / Linux / JNI / so 场景里非常关键。下面一次给你讲透（偏工程实战，不是书本解释）。

一、核心结论先给你

二、System.loadLibrary() 详解

1️⃣ 用法

System.loadLibrary("pgnss_decoder");

JVM 实际会找：

Linux   -> libpgnss_decoder.so
macOS   -> libpgnss_decoder.dylib
Windows -> pgnss_decoder.dll

👉 你传的是逻辑名，不是文件名

2️⃣ JVM 从哪里找？

只在一个地方找：

java.library.path

你可以打印出来看看：

System.out.println(System.getProperty("java.library.path"));

典型 Linux 输出：

/usr/java/packages/lib
/usr/lib64
/usr/lib
/lib64
/lib

3️⃣ so 要放在哪？

三种方式之一即可

✅ 方式 1：放进系统库目录（不推荐容器内）

/usr/lib
/usr/lib64

✅ 方式 2：启动 JVM 时指定

java -Djava.library.path=/opt/native/lib \
     -jar app.jar

✅ 方式 3：Docker / K8s 场景（推荐）

ENV JAVA_OPTS="-Djava.library.path=/opt/native/lib"

/opt/native/lib/libpgnss_decoder.so

4️⃣ 常见坑

❌ 路径里有 so，但报错：

UnsatisfiedLinkError: no pgnss_decoder in java.library.path

原因通常是：

• so 依赖的 其他 so 没找到
• 架构不匹配（x86_64 / aarch64）
• glibc 版本不兼容

👉 用这条命令秒查：

ldd libpgnss_decoder.so

三、System.load() 详解（强烈推荐你现在的场景）

1️⃣ 用法

System.load("/opt/native/lib/libpgnss_decoder.so");

2️⃣ 特点（很重要）

3️⃣ 库放在哪里？

👉 放哪里都行，只要你给的是绝对路径

/opt/native/lib/libpgnss_decoder.so
/app/native/libxxx.so
/tmp/libxxx.so

4️⃣ 依赖库还是要注意！

即使 System.load() 成功：

• 被加载的 so 依赖的 so
• 仍然依赖 Linux 动态链接器

常见解决方式：

export LD_LIBRARY_PATH=/opt/native/lib

或 Docker：

ENV LD_LIBRARY_PATH=/opt/native/lib:$LD_LIBRARY_PATH

四、两者最关键的区别（一句话版）

loadLibrary 是“让 JVM 帮你找” load 是“我告诉 JVM 就在这”

五、JNI + Docker + Linux 的最佳实践（给你一套）

你这个用户背景（JNI + C库 + 容器）👇，推荐方案：

✅ Java 代码

static {
    System.load("/opt/native/lib/libpgnss_decoder.so");
}

✅ Dockerfile

COPY native/libpgnss_decoder.so /opt/native/lib/

ENV LD_LIBRARY_PATH=/opt/native/lib

✅ 验证

ldd /opt/native/lib/libpgnss_decoder.so

六、典型错误对照表

七、一句总结（工程向）

开发机用 loadLibrary，生产 / Docker / K8s 用 load

以上by gpt