JNI 開發核心：對象引用類型與內存洩漏防範全解析

JNI 內存管理的雙重挑戰

JNI（Java Native Interface）讓 Java 與 C/C++ 共舞，但也帶來雙重內存管理負擔：Java 堆與Native 堆。稍有不慎，輕則 OOM，重則 JVM Crash。本文系統梳理三種引用類型生命週期、釋放策略，並針對性給出防洩漏守則。

三大引用類型：生命週期與作用域

局部引用：輕量但危險

局部引用僅在創建它的 native 方法幀中有效。方法返回時 JVM 自動清理，但循環大量創建或長時間運行的 native 方法會導致局部引用表溢出。

// 危險模式：循環內累積局部引用
for (int i = 0; i < hugeCount; i++) {
    jstring s = (*env)->NewStringUTF(env, "data");
    // 缺少 DeleteLocalRef → 局部引用表溢出
}

// 安全模式：及時釋放
for (int i = 0; i < hugeCount; i++) {
    jstring s = (*env)->NewStringUTF(env, "data");
    process(s);
    (*env)->DeleteLocalRef(env, s); // 手動釋放
}

進階技巧：使用 PushLocalFrame/PopLocalFrame 建立嵌套作用域，批量自動釋放：

(*env)->PushLocalFrame(env, 64); // 預留 64 個槽位
// ... 大量局部引用操作 ...
(*env)->PopLocalFrame(env, NULL); // 一鍵清空該幀所有局部引用

全局引用：強大但需謹慎

跨調用、跨線程共享對象的利器，但永久阻止 GC。必須配對 DeleteGlobalRef，否則 Java Heap 洩漏必現。

// 正確緩存 Class 對象
static jclass cachedCls = NULL;
jclass getStringClass(JNIEnv *env) {
    if (cachedCls == NULL) {
        jclass local = (*env)->FindClass(env, "java/lang/String");
        cachedCls = (*env)->NewGlobalRef(env, local); // 升級為全局引用
        (*env)->DeleteLocalRef(env, local);            // 釋放臨時局部引用
    }
    return cachedCls;
}
// 必須在庫卸載或進程結束時調用 DeleteGlobalRef(env, cachedCls)

弱全局引用：緩存不阻礙卸載

適用於 Class 緩存、ClassLoader 可卸載場景。使用前必須用 IsSameObject(env, weakRef, NULL) 檢查對象是否存活（返回 JNI_TRUE 表示已被回收）。

內存洩漏兩大戰場

1. Java Heap 洩漏

• 全局引用未釋放 → 對象長駐堆 → OOM
• Native 代碼持有大量局部引用未清理 → 間接導致堆壓力

2. Native Heap 洩漏

• C/C++ malloc/new 未 free/delete
• JNI 線程創建過多 → 線程棧耗盡 Native Memory
• GetStringUTFChars 未 ReleaseStringUTFChars

JNI 內存管理「鐵律」

1. 誰分配，誰釋放：Native 內存手動管理，JNI 引用嚴格配對 NewXxxRef/DeleteXxxRef。
2. 局部引用不囤積：循環、長運行方法必須手動 DeleteLocalRef 或用 Push/PopLocalFrame。
3. 全局引用有始有終：靜態緩存必須在 JNI_OnUnload 或關閉鉤子中清理。
4. 弱引用用於可卸載緩存：使用前必檢查 IsSameObject。
5. 異常路徑也要清理：goto cleanup 或 RAII 確保所有分支釋放資源。

實戰檢查清單

• ☐ 每個 NewGlobalRef 是否有對應 DeleteGlobalRef？
• ☐ 循環/長運行 native 方法是否控制局部引用數量？
• ☐ GetStringCritical/GetPrimitiveArrayCritical 是否極短時間內釋放？
• ☐ Native 內存分配是否全部配對釋放？
• ☐ 線程創建是否有上限與回收機制？

掌握引用類型語義、建立嚴格釋放紀律，是寫出穩健 JNI 代碼的關鍵。工欲善其事，必先利其器——AddressSanitizer、Valgrind、JVM -verbose:jni 都是排查洩漏的利器，善用之。