Linux下加载多JNI共享库时出现UnsatisfiedLinkError问题

代码示例 #

public class Foo {
    static {
        System.loadLibrary("lib1");
        System.loadLibrary("lib2");
    }
    
    
    public static void main(String[] args) {
        //...
    }
}

问题描述 #

加载lib2时出现UnsatisfiedLinkError（ULE），错误指向一个公有的静态布尔成员字段，根据nm工具显示该字段定义在lib1的bss段中。两个均为共享库，且Xlog:library=info日志显示lib1已成功加载。请问可能的原因是什么？

可能的原因 #

• 符号未导出：编译lib1时可能启用了符号隐藏选项（比如-fvisibility=hidden），导致这个静态布尔字段的符号没有被导出到动态符号表中。即便lib1成功加载，lib2也无法访问到该符号。
• 编译依赖缺失：lib2在编译阶段没有将lib1作为依赖项链接，导致动态加载时无法关联到lib1中的符号。动态链接器无法自动为lib2解析来自lib1的符号引用。
• 初始化时机不匹配：虽然日志显示lib1已加载，但lib1的静态初始化（包括bss段变量的初始化逻辑）可能还未完成，此时lib2尝试访问该字段就会触发错误。
• 架构/ABI不兼容：两个共享库的编译架构（如32位/64位）、ABI标准不一致，导致符号的命名规则或存储格式不匹配，lib2无法识别lib1中的字段符号。
• 符号冲突覆盖：系统中存在其他同名符号被优先加载，覆盖了lib1中的目标字段，导致lib2访问到错误的符号或找不到正确的符号。

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