JavaVM初始化必须在主线程且仅一次，子线程需AttachCurrentThread获取JNIEnv*；GetMethodID失败主因是签名错误、类未加载或方法非public；所有JNI调用返回值和异常均须检查。
JavaVM 初始化必须在主线程完成，且只能调用一次
绝大多数崩溃都源于 JavaVM* 初始化时机错误：在子线程中调用 JNI_CreateJavaVM、重复初始化、或未检查返回值。JVM 要求首次初始化必须发生在主线程（即进程启动后的初始线程），且全局仅允许成功一次。
-
JNI_CreateJavaVM返回JNI_OK才表示成功；返回JNI_ERR或负值时，env和jvm均为无效指针，不可解引用 - 若程序已由 JVM 启动（如 Java 主类调用 C++ 动态库），则应使用
GetCreatedJavaVMs获取已有JavaVM*，而非重新创建 - 务必在
JNI_CreateJavaVM后立即调用jvm->GetEnv检查当前线程是否已关联JNIEnv*；未关联需手动AttachCurrentThread
GetMethodID 失败的常见原因和排查路径
GetMethodID 返回 nullptr 是最常被忽略的错误信号，直接导致后续 CallXXXMethod 崩溃。它不抛异常，只静默失败，必须显式判断。
- 签名字符串写错：Java 方法签名不是简单类型名拼接，例如
String是"Ljava/lang/String;"，数组是"[I"（int[]），void 返回值是"V" - 方法名或类名拼写/大小写错误：Java 类名必须用斜杠分隔，如
"com/example/Utils"，不能写成点号或反斜杠 - 目标方法非 public 或不在指定类中：JNI 只能获取 public 实例方法（静态方法用
GetStaticMethodID），且不支持继承链自动查找 —— 必须精确指定定义该方法的类 - 类未加载：调用
FindClass返回nullptr时，GetMethodID必然失败；可先用env->ExceptionCheck()确认是否有NoClassDefFoundError
JNIEnv* 不是线程安全的，多线程必须 Attach/Detach
每个 OS 线程必须拥有自己的 JNIEnv*。主线程初始化 JVM 后，其 JNIEnv* 仅对该线程有效。其他线程调用 JNI 函数前，必须先调用 jvm->AttachCurrentThread 获取本线程专属的 env，用完后调用 DetachCurrentThread 归还资源。
- 忘记
DetachCurrentThread会导致线程资源泄漏，JVM 可能拒绝后续 Attach 请求 -
AttachCurrentThread成功后，必须用返回的env指针，不能复用主线程的env - 频繁 Attach/Detach 开销较大；若线程长期存在（如工作线程池），建议在初始化时 Attach 并缓存
env，线程退出前 Detach
完整初始化与方法调用示例（含错误检查）
#include#include JavaVM jvm = nullptr; JNIEnv env = nullptr;
bool init_jvm() { JavaVMInitArgs vm_args; JavaVMOption options[2]; options[0].optionString = "-Djava.class.path=."; options[1].optionString = "-Xms32m"; vm_args.version = JNI_VERSION_1_8; vm_args.nOptions = 2; vm_args.options = options; vm_args.ignoreUnrecognized = JNI_FALSE;
jint result = JNI_CreateJavaVM(&jvm, (void**)&env, &vm_args); if (result != JNI_OK) { std::cerr << "Failed to create JVM: " << result << "\n"; return false; } return true;}
bool call_java_method() { jclass cls = env->FindClass("com/example/Calculator"); if (!cls) { std::cerr ExceptionDescribe(); return false; }
jmethodID mid = env->GetMethodID(cls, "add", "(II)I"); if (!mid) { std::cerr << "Method ID not found\n"; env->ExceptionDescribe(); env->DeleteLocalRef(cls); return false; } jobject obj = env->AllocObject(cls); if (!obj) { std::cerr << "Failed to allocate object\n"; env->DeleteLocalRef(cls); return false; } jint result = env->CallIntMethod(obj, mid, 10, 20); std::cout << "Result: " << result << "\n"; env->DeleteLocalRef(obj); env->DeleteLocalRef(cls); return true;
}
注意所有
FindClass、GetMethodID、AllocObject的返回值都必须检查；所有局部引用（jclass、jobject）都必须用DeleteLocalRef释放 —— 这些细节在高并发或长时间运行场景下极易引发内存泄漏或 JVM 崩溃。
, 20);
std::cout << "Result: " << result << "\n";
env->DeleteLocalRef(obj);
env->DeleteLocalRef(cls);
return true;
