为何HotSpot JVM的JNI模块需要使用extern "C"声明？

为什么 JNI 模块需要声明 extern "C"？ #

• 核心原因是 C++ 的 名字修饰（Name Mangling） 机制和 C 不兼容：C++ 为了支持函数重载、命名空间等特性，编译阶段会给原始函数名加上包含参数类型、所属命名空间等信息的特殊后缀，最终生成的符号名和原始函数名差异极大；而 C 语言没有重载能力，编译后符号名和原始函数名完全一致。
• JNI 规范明确约定了本地方法的符号查找规则：JVM 加载本地库时，会按照 C 语言的符号命名规则查找对应 Java native 方法的实现（标准符号格式为 Java_<全限定类名>_<方法名>）。如果 JNI 实现代码用 C++ 编写且未加 extern "C" 声明，编译器生成的符号名会和 JVM 预期的完全不匹配，直接触发 UnsatisfiedLinkError 异常，导致本地方法调用失败。
• 额外保障调用约定一致性：extern "C" 同时会强制使用 C 语言的调用约定，保证参数传递、栈帧处理的逻辑符合 JNI 规范要求，避免不同编译规则带来的调用崩溃问题。

基于 C++ 实现的 JVM 为何需要使用 extern "C" 特性？ #

extern "C" 属于接口层的兼容要求，和 JVM 内部用 C++ 实现互不冲突，它解决的是跨语言、跨模块的符号链接和调用兼容性问题，核心有两个适用场景：

• 对外暴露标准 JNI 接口的兼容需要：JVM 本身会导出一系列标准化的 JNI API（比如 JNI_CreateJavaVM 启动接口、JNIEnv 结构体中的内置方法等），这些接口需要支持被 C、C++ 等不同语言编写的本地程序、本地库链接调用。如果 JVM 编译这些接口时不加 extern "C"，C 语言编写的调用方无法识别 C++ 修饰后的符号名，根本无法正常链接 JVM 的 JNI 接口。
• 加载用户本地库的调用需要：JVM 加载用户实现的 JNI 本地库时，内部是按照 C 语言的符号规则和调用约定去查找、调用本地方法的，JVM 内部处理 JNI 调用的逻辑需要和 C 的接口规则对齐，因此相关的接口声明必须用 extern "C" 修饰，保证整个调用链路的一致性。

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