Java调用C/C++：JNI实战教程详解

本文深入浅出地讲解了Java通过JNI调用C/C++代码的完整实战流程，从Java端native方法声明、动态库加载时机与命名规范，到使用javac -h生成标准JNI头文件、C端正确处理JNIEnv*和jobject、字符串内存管理、跨语言方法调用，再到Linux下编译共享库的关键编译选项（-fPIC、-shared）和符号导出排查技巧，直击开发者在JNI集成中最常踩的“签名不匹配”“符号未导出”“内存泄漏”“线程JNIEnv误用”等隐性坑点，是一份聚焦真实问题、强调可落地细节的高效入门指南。

Java里怎么写一个能调用C函数的类

必须声明 native 方法，且不能有方法体；类本身不需要特殊修饰，但加载动态库的逻辑得自己写。JVM靠方法签名（包括包名、参数类型、返回值）在本地库中找对应函数，签名不对就直接抛 UnsatisfiedLinkError。

• 在Java类里用 public native int add(int a, int b); 声明，别加 {}
• 用 System.loadLibrary("mylib"); 加载，注意参数是库名（Linux下是 libmylib.so，Windows是 mylib.dll），不是文件全名
• 加载必须在任何 native 方法被调用前完成，通常放静态块里：

  static { System.loadLibrary("mylib"); }

• 包名影响生成的C函数名，com.example.Calculator.add 对应的C函数名是 Java_com_example_Calculator_add，手写时拼错一个下划线或大小写都会失败

javah 已废弃，现在怎么生成头文件

从 JDK 10 开始 javah 被移除，改用 javac -h 直接生成JNI头文件。它只认已编译的 .class 文件，不接受源码路径或未编译的 .java。

• 先编译好你的Java类：javac com/example/Calculator.java
• 再生成头文件：javac -h ./jni com/example/Calculator.class，-h 后面是输出目录
• 生成的 com_example_Calculator.h 里包含标准JNI函数签名和宏定义，别手动改它
• 如果提示找不到类，检查 classpath 是否包含 com/example/ 的父目录，或者用 -cp . 显式指定

写C函数时 JNIEnv\* 和 jobject 参数到底怎么用

JNIEnv* 是JNI提供的操作句柄，所有JNI函数（如取字符串、新建对象、抛异常）都靠它；jobject 在非静态native方法中是this引用，静态方法中是Class对象——漏传或误用会导致崩溃或空指针。

• 访问Java字符串要用 (*env)->GetStringUTFChars(env, jstr, NULL)，用完必须配对调用 (*env)->ReleaseStringUTFChars(env, jstr, cstr)，否则内存泄漏
• 返回新字符串用 (*env)->NewStringUTF(env, "hello")，不能直接 return C 字符串字面量
• 调用Java方法要先通过 (*env)->GetObjectClass(env, obj) 拿Class，再用 GetMethodID 查方法ID，最后 CallVoidMethod 等触发调用
• 不要在线程间共享 JNIEnv*：每个线程必须用 AttachCurrentThread 获取自己的 JNIEnv*

Linux下编译so总报 undefined symbol: Java\_xxx

常见原因是C函数名和Java声明不匹配，或者链接时没导出符号。GNU工具链默认隐藏符号，而JNI要求函数全局可见。

• 确保C函数名严格按 javac -h 生成的头文件里写的来，比如 Java_com_example_Calculator_add，少一个下划线或大小写错都不行
• gcc编译so时加 -fPIC（位置无关代码），链接时加 -shared，例如：

  gcc -fPIC -shared -o libmylib.so mylib.c

• 用 nm -D libmylib.so 检查符号是否导出，如果没看到 Java_... 行，说明函数没被识别为全局符号
• 某些旧版NDK或交叉编译环境需要额外加 -Wl,--export-dynamic，但普通Linux gcc一般不需要

JNI最麻烦的从来不是写几行C，而是两端签名对不上、符号没导出、字符串没释放、线程没attach——这些地方一错，错误信息往往只报“no implementation found”，实际得一层层反向核对。

终于介绍完啦！小伙伴们，这篇关于《Java调用C/C++：JNI实战教程详解》的介绍应该让你收获多多了吧！欢迎大家收藏或分享给更多需要学习的朋友吧~golang学习网公众号也会发布文章相关知识，快来关注吧！