如何在AOT编译的Java应用中用CNI调用动态链接本地库？

核心结论 #

CNI支持动态链接，但在AOT编译场景下存在符号导出的已知问题，需通过调整编译选项和代码属性来规避。

问题根源 #

当使用CNI结合AOT编译+动态链接时，链接阶段出现hidden alias for void Main::foo()未定义符号错误，本质是GCJ生成的CNI方法符号默认带有静态/隐藏可见性，动态库无法导出这类符号，导致AOT编译的可执行文件无法解析。

可行解决方案 #

1. 强制导出CNI符号

在C++实现的CNI方法中添加可见性属性，同时编译动态库时指定全局可见性：

• CNI代码示例：

  #include <gcj/cni.h>
  
  // 强制符号可见，供动态链接使用
  void __attribute__((visibility("default"))) Main::foo() {
      // 本地方法逻辑
  }
  

• 编译动态库的命令：

  g++ -shared -fPIC -fvisibility=default -o libfoo.so foo.cpp `gcj-config --cflags --libs`
  

2. 改用运行时动态加载

保留Java代码中的System.loadLibrary("foo")，AOT编译时不直接链接动态库，让程序运行时通过动态加载获取符号：

• 编译Java代码为AOT可执行文件：

  gcj -c Main.java
  gcj -o main Main.o `gcj-config --libs`
  

• 运行时确保动态库路径可用（或用-rpath指定）：

  # 方式1：设置环境变量
  export LD_LIBRARY_PATH=/path/to/lib:$LD_LIBRARY_PATH
  ./main
  
  # 方式2：编译时指定rpath
  gcj -o main Main.o -Wl,-rpath=/path/to/lib `gcj-config --libs`
  ./main
  

3. 验证符号导出

用nm命令检查动态库是否正确导出CNI符号：

nm -D libfoo.so | grep "Main::foo"

正常情况下应输出类似_ZN4Main3fooEv的C++ mangled符号。

已知限制 #

• 该问题存在官方Bug报告，但暂无正式修复方案，上述方法为社区实践中的临时规避手段。
• CNI静态链接、JNI动态链接不受此问题影响，可正常使用。

内容的提问来源于stack exchange，提问作者Андрей Щеглов