树莓派5 64位OpenJDK17下BlueCove JNI库hci_get_route符号查找失败

日志中“Failed to find”行的含义 #

这行日志明确表示：动态库libbluecove_aarch64.so在尝试解析libbluetooth.so中的hci_get_route符号时失败。即便两个库都被JVM成功加载，仍出现该错误的核心原因是：符号的名称/签名不匹配、BlueCove编译依赖的libbluetooth版本与树莓派当前版本ABI不兼容，或是hci_get_route符号未被libbluetooth.so导出。

解决符号查找错误的步骤 #

1. 验证libbluetooth的符号导出情况 #

首先确认libbluetooth.so确实导出了hci_get_route符号：

nm -D /usr/lib/aarch64-linux-gnu/libbluetooth.so | grep hci_get_route

• 如果无输出，说明当前安装的libbluetooth版本未包含该符号，需安装开发版依赖：

  sudo apt update && sudo apt install libbluetooth-dev
  

  再次运行上述nm命令检查符号是否出现。

2. 重新编译适配aarch64架构的BlueCove #

预编译的BlueCove库可能未适配树莓派5的aarch64环境，需手动从源码编译：

• 安装编译依赖：

  sudo apt install openjdk-17-jdk libbluetooth-dev gcc-aarch64-linux-gnu git make
  

• 克隆BlueCove源码并编译：

  git clone https://github.com/bluecove/bluecove.git
  cd bluecove
  # 针对aarch64调整编译参数，可修改Makefile中的CFLAGS，添加-march=armv8-a
  make
  

  编译完成后，将生成的libbluecove_aarch64.so替换原有的库文件。

3. 调整库加载路径与顺序 #

确保JVM能正确找到依赖库：

• 运行程序前设置环境变量，指定库路径优先级：

  export LD_LIBRARY_PATH=/usr/lib/aarch64-linux-gnu:/path/to/your/bluecove/libs:$LD_LIBRARY_PATH
  

• 或通过JVM参数直接指定库路径：

  java -Djava.library.path=/usr/lib/aarch64-linux-gnu:/path/to/your/bluecove/libs -Xlog:library=info -jar your-java-app.jar
  

4. 检查libbluetooth的符号链接正确性 #

确认libbluetooth.so指向的是当前系统的有效版本：

ls -l /usr/lib/aarch64-linux-gnu/libbluetooth.so

如果链接指向旧版本或无效文件，手动重新建立链接（以实际安装的版本为例）：

sudo ln -sf /usr/lib/aarch64-linux-gnu/libbluetooth.so.3.20 /usr/lib/aarch64-linux-gnu/libbluetooth.so

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