Java native方法通过JNI调用C代码的核心是JVM准确查找并加载对应函数，涉及四步：1. Java中声明native方法并用javac -h生成头文件；2. C中严格按JNI命名规则（如Java_Package_Class_method）实现函数，注意JNIEnv*和jobject参数及类型映射；3. 编译为平台特定动态库（如libxxx.so），库名须与System.loadLibrary("xxx")一致；4. 运行时确保库路径正确，否则抛UnsatisfiedLinkError。
Java 中的 native 方法通过 JNI（Java Native Interface）调用 C 代码，核心是让 JVM 能找到并正确加载对应 C 函数。关键在于函数命名规则、动态库编译与加载、以及类型映射的准确性。
1. 声明 native 方法并生成头文件
在 Java 类中用 native 关键字声明方法，不写实现。例如：
public class NativeExample {
public native int add(int a, int b);
static {
System.loadLibrary("nativeexample"); // 加载名为 libnativeexample.so/.dll 的库
}
}然后用 javac 编译该类，再用 javah（JDK 8 及以前）或 javac -h（JDK 9+）生成 C 头文件：
javac NativeExample.java javac -h . NativeExample.java // 生成 NativeExample.h
生成的头文件里包含符合 JNI 规范的函数签名，如：
立即学习“Java免费学习笔记（深入）”；
JNIEXPORT jint JNICALL Java_NativeExample_add (JNIEnv *, jobject, jint, jint);
2. 实现 C 函数并注意命名与参数
编写 NativeExample.c，包含生成的头文件，并实现对应函数：
#include "NativeExample.h"
#include <jni.h>
<p>JNIEXPORT jint JNICALL Java_NativeExample_add
(JNIEnv *env, jobject obj, jint a, jint b) {
return a + b;
}注意三点：
- 函数名必须严格匹配头文件中的声明（含包路径下划线转义，如
com_example_Test→Java_com_example_Test_method） - 前两个参数固定：JNIEnv* 用于调用 JNI 接口，jobject/jclass 是调用对象或类引用
- 后续参数顺序和类型须与 Java 方法一致，基本类型直接对应（
jint→int），引用类型需用 JNI 函数操作
3. 编译成动态链接库
根据操作系统编译为共享库：
- Linux：
gcc -shared -fPIC -I${JAVA_HOME}/include -I${JAVA_HOME}/include/linux NativeExample.c -o libnativeexample.so - macOS：
gcc -shared -fPIC -I${JAVA_HOME}/include -I${JAVA_HOME}/include/darwin NativeExample.c -o libnativeexample.dylib - Windows：
gcc -shared -I"%JAVA_HOME%\include" -I"%JAVA_HOME%\include\win32" NativeExample.c -o nativeexample.dll
确保库文件名与 System.loadLibrary("xxx") 中的名称一致（去掉 lib 前缀和后缀）。
4. 运行时加载与常见问题
Java 启动时需让 JVM 找到库文件：
- 把编译好的库放在系统路径（如
/usr/lib）或当前工作目录 - 或通过
-Djava.library.path=路径指定目录 - 也可用
System.load("/absolute/path/to/libnativeexample.so")加载绝对路径
典型报错及原因：
-
UnsatisfiedLinkError：库名错误、路径不对、函数名拼写/大小写不符、未导出符号（Linux/macOS 需加-shared） - C 函数返回值或参数类型不匹配：比如 Java 是
long，C 用了int，会导致栈错乱 - 静态块中
loadLibrary调用位置错误：必须在 native 方法被调用前完成加载
不复杂但容易忽略细节，尤其是函数签名和库路径。只要命名对、编译对、加载对，JNI 调用就可靠。
