JNI 中 String 類型正確使用姿勢：GetStringUTFChars 與 ReleaseStringUTFChars 配對指南

前言

JNI 開發中 Java String 傳遞至 C/C++ 是高頻操作。本文詳細說明 jstring 轉 char* 的標準流程、內存管理機制及常見錯誤，確保無內存洩漏、無崩潰。

一、核心 API 對照

二、標準使用模板

JNIEXPORT void JNICALL 
Java_HelloWorld_displayHelloWorld(JNIEnv *env, jobject obj, jstring s) {
    // 1. 空指針防護
    if (s == NULL) return;

    // 2. 獲取 UTF-8 C 字串指針
    // isCopy 為 NULL 表示不關心是否拷貝
    const char *str = (*env)->GetStringUTFChars(env, s, NULL);
    if (str == NULL) return; // OOM 保護

    // 3. 業務邏輯使用 str
    printf("Received from Java: %s\n", str);
    // 可在此處調用其他 C 函數處理字串

    // 4. **必須**釋放資源，配對調用
    (*env)->ReleaseStringUTFChars(env, s, str);
}

三、內存管理機制深度解析

3.1 為什麼需要 Release？

• Java 字串在堆中，可能被 GC 移動
• GetStringUTFChars 可能：固定對象 (pinning) 防止 GC 移動，或 拷貝 到 C 堆
• 無論哪種實現，必須調用 Release 通知 JVM「C 端不再訪問」
• 若固定對象，Release 解除固定讓 GC 恢復移動；若拷貝，Release 釋放 C 內存

3.2 isCopy 參數實戰意義

jboolean isCopy;
const char *str = (*env)->GetStringUTFChars(env, s, &isCopy);
if (isCopy == JNI_TRUE) {
    // JVM 拷貝了字串，str 指向 C 堆內存
    // Release 會 free 這塊內存
} else {
    // JVM 固定了 Java 對象，str 直接指向堆內部
    // Release 會解除固定
}

無論 isCopy 真假，**Release 邏輯統一**，無需分支處理。

四、常見致命錯誤

五、異常安全模式 (C++ RAII 封裝)

class ScopedUtfChars {
public:
    ScopedUtfChars(JNIEnv* env, jstring s) : env_(env), str_(s) {
        chars_ = env_->GetStringUTFChars(str_, NULL);
    }
    ~ScopedUtfChars() {
        if (chars_) env_->ReleaseStringUTFChars(str_, chars_);
    }
    const char* get() const { return chars_; }
private:
    JNIEnv* env_;
    jstring str_;
    const char* chars_;
};

// 使用示例
JNIEXPORT void JNICALL Java_HelloWorld_display(JNIEnv* env, jobject obj, jstring s) {
    ScopedUtfChars scoped(env, s);
    const char* str = scoped.get();
    if (str) printf("%s\n", str);
    // 離開作用域自動 Release，異常安全
}

六、編碼陷阱提醒

• GetStringUTFChars 返回 **Modified UTF-8**，補文字符 (U+0000) 編碼為 0xC0 0x80 而非單字節 0x00
• 標準 C 庫函數 (strlen, strcmp) 可能誤判長度/內容
• 需處理補文字符時，改用 GetStringChars 獲取 UTF-16 jchar* 配合 ICU 庫

七、總結

GetStringUTFChars / ReleaseStringUTFChars 必須成對調用，作用域內使用，異常安全封裝。理解 JVM 固定/拷貝雙模式，避開編碼陷阱，即可編寫健壯的 JNI 字串交互代碼。