SpringBoot集成RDKit遇UnsatisfiedLinkError，独立Java程序正常

你遇到的java.lang.UnsatisfiedLinkError本质是JNI方法签名不匹配或动态库未正确加载，以下是针对性的解决方法：

1. 调整动态库加载时机 #

SpringBoot的类加载机制与普通Java程序不同，直接在业务代码中加载库可能时机过晚。建议在Spring容器初始化阶段加载：

import org.springframework.stereotype.Component;
import javax.annotation.PostConstruct;

@Component
public class RDKitLoader {
    @PostConstruct
    public void initRDKit() {
        System.loadLibrary("GraphMolWrap");
    }
}

也可以直接在SpringBoot启动类的main方法最前端加载：

@SpringBootApplication
public class YourApp {
    public static void main(String[] args) {
        System.loadLibrary("GraphMolWrap");
        SpringApplication.run(YourApp.class, args);
    }
}

2. 严格匹配RDKit Jar与动态库版本 #

确保pom.xml中引入的RDKit Jar包版本，和你使用的GraphMolWrap.dll版本完全一致。版本不匹配会导致JNI方法签名错位，直接触发该错误。

3. 解决打包/运行时的动态库路径问题 #

如果SpringBoot打包为可执行Jar，JVM可能无法找到动态库：

• 把GraphMolWrap.dll放到系统PATH环境变量包含的目录（比如Windows的C:\Windows\System32）；
• 启动Jar时通过JVM参数指定库路径：

  java -Djava.library.path="你的dll所在目录" -jar your-springboot-app.jar
  

• 用Maven插件将dll打包到Jar内部的指定目录，比如用maven-resources-plugin将dll复制到target/classes/lib，启动时指定该路径。

4. 验证JVM与动态库架构匹配 #

确认运行SpringBoot的JVM架构（32/64位）和GraphMolWrap.dll的编译架构一致。通过java -version命令查看JVM架构，比如输出中的64-Bit标识。

5. 排查依赖冲突 #

检查项目依赖树，确认是否有其他依赖引入了不同版本的RDKit相关Jar：

mvn dependency:tree

若发现冲突，在pom.xml中通过<exclusions>标签排除冲突依赖。

调试小技巧 #

加载库前后打印java.library.path，确认路径是否包含你的dll目录：

System.out.println(System.getProperty("java.library.path"));

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