Raspberry Pi 4部署Java SQLite应用遇NativeLibraryNotFoundException排查

• 强制指定架构加载
  Java 8在aarch64平台上的架构识别可能存在偏差，导致sqlite-jdbc无法自动匹配对应本地库。可以通过以下两种方式指定：

  • JVM启动参数添加：

    -Dorg.sqlite.os=Linux -Dorg.sqlite.arch=aarch64
    

  • 代码中加载驱动前设置系统属性：

    System.setProperty("org.sqlite.os", "Linux");
    System.setProperty("org.sqlite.arch", "aarch64");
    Class.forName(DEF_JDBC_CLASS_NAME);
    Connection objConnection = DriverManager.getConnection("jdbc:sqlite:" + sDataBasePath);
    

• 手动提取并指定本地库路径
  从sqlite-jdbc-3.44.1.0.jar中提取org/sqlite/native/Linux/aarch64/libsqlitejdbc.so文件，将其放到树莓派的本地库目录（如/usr/local/lib），然后通过JVM参数或代码指定库路径：

  • JVM启动参数：

    -Djava.library.path=/usr/local/lib
    

  • 代码中设置（Java 8需强制刷新路径）：

    System.setProperty("java.library.path", "/usr/local/lib");
    // 刷新类加载器的系统库路径
    Field fieldSysPath = ClassLoader.class.getDeclaredField("sys_paths");
    fieldSysPath.setAccessible(true);
    fieldSysPath.set(null, null);
    

• 检查Java运行时架构匹配
  执行java -version命令，确认输出中的架构为aarch64。如果显示为armhf，说明安装的是32位Java环境，需重新安装适配aarch64的64位Java 8版本。

• 验证sqlite-jdbc包完整性
  重新下载sqlite-jdbc-3.44.1.0.jar，检查包内是否存在org/sqlite/native/Linux/aarch64/libsqlitejdbc.so文件，排除包损坏导致的本地库缺失问题。

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