Rust cc-rs构建hdfs-jni时指定libjvm.so路径仍无法找到问题

核心问题根因 #

你遇到的不是cc编译环节的错误，属于动态链接顺序、符号版本匹配、路径配置三类问题叠加的结果，具体原因如下：

• 链接顺序错误：链接器按参数传入顺序处理依赖库，你仅配置了libjvm.so的搜索路径，既没有显式声明libjvm为链接依赖，且libhdfs.so在链接参数中的顺序早于libjvm，导致链接器处理libhdfs的未定义符号时，还未加载libjvm的符号表，直接判定符号缺失。
• 私有符号绑定问题：你使用的OpenJDK版本将JNI_CreateJavaVM、JNI_GetCreatedJavaVMs等JNI接口标记为私有版本SUNWprivate_1.1，Hadoop官方提供的libhdfs.so编译时绑定的就是该带版本号的符号，未显式链接对应版本libjvm时，链接器只会匹配默认版本的JNI符号，直接报未定义引用。
• 路径配置不匹配：你在RUSTFLAGS中传入的-L /usr/local/hadoop/lib/native是libhdfs.so的存放路径，并非libjvm.so的路径；且build.rs中配置的链接搜索路径仅在构建当前crate时生效，测试运行时动态链接器还是会从系统默认路径查找依赖，找不到libjvm.so就会报错。

修复方案 #

按以下步骤调整即可解决问题：

1. 在build.rs中，除了保留原有的libjvm搜索路径配置，新增显式链接libjvm的声明，且要放在链接libhdfs的声明之前，保证链接顺序正确：

println!("cargo:rustc-link-lib=dylib=jvm");

2. 执行测试前，同时配置编译链接搜索路径和运行时动态库搜索路径，将libjvm.so、libhdfs.so的路径都传入对应环境变量，示例命令如下（将/path/to/jre替换为你实际的JDK安装路径）：

LD_LIBRARY_PATH=/path/to/jre/lib/amd64/server:/usr/local/hadoop/lib/native \
RUSTFLAGS='-L /usr/local/hadoop/lib/native -L /path/to/jre/lib/amd64/server' \
cargo test

3. 若调整后仍有符号报错，可通过以下两个命令确认符号版本是否匹配，保证libhdfs.so依赖的JNI符号版本和你使用的libjvm.so提供的版本一致：

# 查看libhdfs.so依赖的JNI符号版本
objdump -T /usr/local/hadoop/lib/native/libhdfs.so | grep JNI_CreateJavaVM
# 查看libjvm.so提供的JNI符号版本
objdump -T /path/to/jre/lib/amd64/server/libjvm.so | grep JNI_CreateJavaVM

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