Gradle集成Rust原生库（Project Panama）启动报错排查

一、库文件必须放在Gradle识别的原生资源目录 #

Gradle不会自动识别src/main/rust下的原生库，你需要把libprocess_dlms.dylib放到系统对应的原生资源子目录：

• MacOS（arm64架构）：src/main/resources/native/macosx/aarch64
• MacOS（x86_64架构）：src/main/resources/native/macosx/x86_64
  其他系统同理（比如Linux是linux/x86_64，Windows是windows/x86_64）。
  Gradle会自动把这些目录下的库打包到应用JAR的对应路径，运行时Java能自动检索到。

二、修正Gradle配置 #

你之前用的implementation(fileTree("src/main/rust"))完全不对，这是用来引入Java类或普通资源的，原生库需要调整Gradle的运行时参数和资源配置：
在build.gradle.kts中添加：

// 配置Java运行时参数，启用Native Access
tasks.withType<JavaExec> {
    jvmArgs("--enable-native-access=ALL-UNNAMED")
    // 指定原生库搜索路径
    systemProperty("java.library.path", "${projectDir}/src/main/resources/native/${System.getProperty("os.name").lowercase().replace(" ", "")}/${System.getProperty("os.arch")}")
}

// 确保原生资源被正确包含
sourceSets {
    main {
        resources {
            srcDirs("src/main/resources")
        }
    }
}

如果用Micronaut的application插件，还要补充启动参数：

plugins {
    id("application")
}

application {
    mainClass.set("你的主类全路径")
    applicationDefaultJvmArgs = listOf(
        "--enable-native-access=ALL-UNNAMED",
        "-Djava.library.path=${projectDir}/src/main/resources/native/${System.getProperty("os.name").lowercase().replace(" ", "")}/${System.getProperty("os.arch")}"
    )
}

三、正确使用System.load/System.loadLibrary #

• 优先用System.loadLibrary("process_dlms")：Java会自动根据系统补全前缀（MacOS的lib）和后缀（.dylib），不需要写全文件名。
• 如果用绝对路径System.load()，先打印路径验证文件是否存在：

File libFile = new File("/absolute/path/to/libprocess_dlms.dylib");
System.out.println(libFile.exists() ? "文件存在" : "文件不存在");

如果显示“文件不存在”，说明你写的绝对路径肯定错了，检查大小写、目录层级是否正确。

四、查看Java的库搜索路径 #

运行时直接打印java.library.path就能看到Java会搜索哪些目录：

System.out.println("Java库搜索路径：" + System.getProperty("java.library.path"));

你可以对比这个路径，看你的库所在目录是否在里面，不在的话就通过-Djava.library.path参数添加。

五、Micronaut打包验证 #

打包成JAR后，解压看看JAR内部是否有native/xxx/xxx/libprocess_dlms.dylib，如果没有，说明Gradle没把库打包进去，检查sourceSets配置是否正确。

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