Java Maven项目集成Vosk时遭遇UnsatisfiedLinkError问题求助

问题根源 #

你遇到的java.lang.UnsatisfiedLinkError是因为Vosk的Java JNI接口声明与实际加载的本地Native库版本不兼容——JNI层调用了vosk_recognizer_set_grm函数，但当前加载的Native库中没有这个符号，通常是依赖版本不匹配或本地库未正确加载导致的。

具体解决步骤 #

1. 对齐Vosk依赖与Native库版本 #

你当前使用的Vosk Maven版本0.3.45可能存在JNI与Native库的兼容性问题，建议更换为经过验证的稳定版本，比如0.3.32：
修改你的Maven依赖：

<dependency>
    <groupId>com.alphacephei</groupId>
    <artifactId>vosk</artifactId>
    <version>0.3.32</version>
</dependency>

这个版本的JNI接口与自带的Native库匹配度更高，不会出现符号缺失问题。

2. 修正模型路径的加载逻辑 #

直接使用src/main/resources相对路径在打包后会失效，改用类加载器获取classpath下的模型路径：

// 从classpath中获取模型目录的绝对路径
String modelPath = new File(
    SpeechConverter.class.getResource("/vosk-model-small-en-us-0.15").getPath()
).getAbsolutePath();
Model model = new Model(modelPath);

确保IDE中src/main/resources被标记为资源根目录，Maven会自动将该目录下的内容复制到编译后的classpath中。

3. 手动指定Native库路径（自动加载失败时） #

如果Maven依赖的Native库未被自动加载，可手动指定：

1. 下载与你使用的Vosk版本完全匹配的平台Native库：
   • Windows：vosk.dll
   • macOS：libvosk.dylib
   • Linux：libvosk.so
2. 将Native库放入项目的src/main/resources/native/[平台]目录（比如src/main/resources/native/macos）。
3. 在程序启动时设置JVM参数指定库路径：

   // 在main方法最开头添加
   System.setProperty("jna.library.path", "src/main/resources/native/你的平台目录");
   

   或者在IDE运行配置中添加VM参数：-Djna.library.path=src/main/resources/native/macos（根据你的系统调整）。

4. 清理重构项目 #

执行Maven命令清理旧依赖和编译文件，确保新依赖生效：

mvn clean install

重启IDE后再运行程序。

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