共计 1589 个字符，预计需要花费 4 分钟才能阅读完成。

背景痛点：为什么需要这个参数？

最近在给一个老项目升级 JDK 时，突然遇到 java.lang.UnsatisfiedLinkError: Permission denied 错误。原本在 JDK8 运行正常的 JNI 调用，切换到 JDK17 后直接罢工。这其实是 JDK16 引入的强封装性机制在作祟——从 JDK9 模块化开始，JVM 对 native 访问的管控越来越严格。

技术解析：参数背后的故事

1. JDK 模块化前后的分水岭
2. JDK8 及之前：JNI 调用默认畅通无阻
3. JDK9~15：开始警告但未强制限制（可通过 --illegal-access=warn 看到提示）

4. JDK16+：默认禁止未经授权的 native 访问（强封装性）

5. –enable-native-access 的职责
   这个参数相当于给指定模块发放了native 通行证，格式为：

   --enable-native-access=MODULE1,MODULE2

   特殊值 ALL-UNNAMED 代表对未命名模块放行（常见于传统项目）

配置实战：手把手教你设置

IntelliJ IDEA 可视化配置

1. 打开 Run/Debug Configurations 窗口
2. 在 VM options 栏添加（示例允许所有未命名模块）：

   --enable-native-access=ALL-UNNAMED

   

构建工具配置示例

Gradle 配置（Java 17+）

tasks.withType(JavaExec).configureEach {jvmArgs '--enable-native-access=ALL-UNNAMED'}

Maven 配置

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-surefire-plugin</artifactId>
    <configuration>
        <argLine>--enable-native-access=ALL-UNNAMED</argLine>
    </configuration>
</plugin>

避坑指南：跨平台注意事项

• Windows：注意路径反斜杠转义问题

  -Djava.library.path=C:\\path\\to\\dll

• macOS/Linux：需要执行权限

  chmod +x libnative.dylib

• SecurityManager 共存时：需额外配置策略文件

  System.setProperty("java.security.policy", "path/to/your.policy");

验证方案：测试你的配置

public class JNITest {
    // 加载 native 库
    static {System.loadLibrary("native");
    }

    // 声明 native 方法
    public static native int add(int a, int b);

    public static void main(String[] args) {System.out.println(add(1, 2)); // 预期输出 3
    }
}

进阶技巧：参数组合使用

当遇到反射访问限制时，可以组合使用：

--enable-native-access=ALL-UNNAMED \
--add-opens java.base/java.lang=ALL-UNNAMED

排查流程图

graph TD
    A[报错 Permission denied] --> B{是否添加参数?}
    B -->| 否 | C[添加 --enable-native-access]
    B -->| 是 | D{模块名是否正确?}
    D -->| 否 | E[修正模块名]
    D -->| 是 | F[检查.so/.dll 加载路径]

动手实验

现在请尝试：
1. 创建一个简单的 JNI 类
2. 生成头文件并实现 C 函数
3. 配置 IDEA 使调用成功

提示命令：

javac -h . JNITest.java

遇到问题时可参考我们的排查流程图，欢迎在评论区分享你的实验成果！