Java启动时LD_LIBRARY_PATH不生效的典型表现是进程找不到.so文件，报UnsatisfiedLinkError；该错误反映java.library.path未命中，而LD_LIBRARY_PATH用于解决.so自身依赖的共享库加载问题，二者作用域不同，需分别配置。
Java启动时LD_LIBRARY_PATH不生效的典型表现
Java进程根本找不到你放好的.so文件，报错信息里准有UnsatisfiedLinkError: no xxx in java.library.path——注意，这个错误和LD_LIBRARY_PATH无关，它只反映java.library.path里没搜到；而LD_LIBRARY_PATH是给动态链接器（ld-linux）用的，影响的是.so自身依赖的其他共享库能否加载成功。两者常被混为一谈，但解决路径完全不同。
设置LD_LIBRARY_PATH必须在java命令之前生效
在Shell里写export LD_LIBRARY_PATH=/path/to/so:$LD_LIBRARY_PATH再跟java -jar app.jar，看似合理，实则高危：如果Java进程是fork出来的子进程（比如被systemd、supervisor或Docker entrypoint包装过），环境变量大概率被清空或覆盖。最稳妥的方式是把LD_LIBRARY_PATH直接塞进启动命令里：
LD_LIBRARY_PATH=/opt/mylib:/usr/local/lib java -Djna.library.path=/opt/mylib -jar app.jar
- 不要依赖shell profile或.bashrc，生产环境往往不走交互式shell
- 如果用Docker，必须在
ENV LD_LIBRARY_PATH /opt/mylib之后再执行java，且不能写在单独的RUN指令里 - systemd服务中需显式写
Environment=LD_LIBRARY_PATH=/opt/mylib，仅靠ExecStart前加前缀不可靠
JNI加载时优先走System.load()而非System.loadLibrary()
当你的.so带版本号或路径不标准（比如叫libmylib.so.2.1），别硬套System.loadLibrary("mylib")——它会强行拼出libmylib.so去java.library.path里找，失败率极高。直接上绝对路径更可控：
当用户要求为 Java 代码添加注释、修改注释、审查注释、整理注释格式，或要求按照代码注释规范处理 Java 文件时，使用本技能。本技能用于统一生成和维护 Java 类注释模板、按 Git 对比 release 判断版本号、补充每行代码上方中文块注释、调整注释空行规则，并保持 Java 文件 UTF-8 无 BOM 编码。典型触发场景包括：补充类注释、更新 @version、检查 @author 来源、整理行尾注释、把注释放到代码上一行、检查注释是否符合规范、构建前检查 Java 注释风格。
static {
System.load("/opt/mylib/libmylib.so.2.1");
}
-
System.load()传绝对路径，绕过所有路径拼接逻辑，适合非标命名或需要精确控制版本的场景 -
System.loadLibrary()适合标准命名+已配置好java.library.path的情况，但要注意它不读LD_LIBRARY_PATH - 如果.so依赖其他.so（比如依赖
libcrypto.so.1.1），这些依赖必须能被ld-linux找到——此时LD_LIBRARY_PATH才真正起作用
排查.so依赖缺失比猜错路径更常见
现象是调用JNI函数时JVM直接崩溃（SIGSEGV），日志里没有Java异常，只有hs_err_pid*.log里的native stack trace。这时候大概率是.so加载了，但它依赖的某个底层库没找到。验证方法很简单：
立即学习“Java免费学习笔记（深入）”；
ldd /opt/mylib/libmylib.so.2.1 | grep "not found"
- 输出里任何
not found都意味着LD_LIBRARY_PATH缺了对应路径 - 特别注意glibc版本兼容性：
GLIBC_2.28这种符号在CentOS 7（glibc 2.17）上必然失败，换低版本编译或升级系统 - 用
readelf -d libmylib.so | grep NEEDED看它到底要哪些库，比盲目加路径更高效
真正卡住人的从来不是“怎么设LD_LIBRARY_PATH”，而是设完之后，你不知道该路径下到底缺哪个依赖、缺的是符号还是整个文件、甚至缺的是glibc主版本——这些得一层层敲命令确认，没法靠配置一次到位。
