Scala调用C++函数遇架构不兼容UnsatisfiedLinkError问题求助

一、核心问题定位 #

从错误信息可以明确两个关键问题：

1. 架构不兼容：你的Java环境是x86_64架构，而编译生成的C++共享库是arm64架构，导致无法加载。
2. 代码中的库加载错误：Java类和Scala代码里的System.load存在路径错误、无效调用的问题。

二、解决架构不兼容问题 #

1. 编译对应x86_64架构的共享库 #

因为你的Java是x86_64版本，需修改g++编译命令，指定目标架构：

# 编译x86_64架构的库
g++ -shared -o libexample.so -arch x86_64 example.cpp

如果需要同时兼容arm64和x86_64（通用二进制），可以用：

g++ -shared -o libexample.so -arch arm64 -arch x86_64 example.cpp

2. 验证库架构 #

编译完成后，用以下命令确认库的架构：

file libexample.so

输出应包含x86_64（或同时包含arm64和x86_64）。

三、修复代码中的库加载错误 #

1. 修正Java类（NativeLibrary.java） #

原代码中System.load路径末尾多了一个无效的冒号，同时无需重复加载库：

public class NativeLibrary {
    static {
        // 去掉路径末尾的冒号，使用正确的绝对路径
        System.load("/Users/xyz/xyz/app/test2/libexample.so");
    }

    public static native void printSomething();
}

2. 修正Scala代码（Main.scala） #

原代码中System.load("")是空字符串调用，完全无效，且NativeLibrary的静态块已经完成库加载，直接删除该行：

object Main extends App {
    // 直接调用native方法，无需重复加载库
    NativeLibrary.printSomething()
}

四、使用System.loadLibrary的正确方式（可选） #

如果不想写绝对路径，可使用System.loadLibrary，需按以下步骤操作：

1. 修改库命名（符合macOS惯例）：

g++ -shared -o libexample.dylib -arch x86_64 example.cpp

2. 更新Java类的静态块：

public class NativeLibrary {
    static {
        // 库名仅需写"example"，自动匹配lib前缀和.dylib后缀
        System.loadLibrary("example");
    }

    public static native void printSomething();
}

3. 运行时指定库搜索路径：
   执行Scala程序时，通过-Djava.library.path参数指定库所在目录：

scala -Djava.library.path=/Users/xyz/xyz/app/test2 Main

如果使用sbt构建，在build.sbt中添加：

fork := true
javaOptions += "-Djava.library.path=/Users/xyz/xyz/app/test2"

五、验证执行流程 #

1. 重新编译C++共享库
2. 编译Java类：javac NativeLibrary.java
3. 编译Scala代码：scalac Main.scala
4. 运行程序：scala Main（使用绝对路径加载时）或带参数运行（使用loadLibrary时）

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