本文详解如何在 Android 原生开发中安全、高效地通过 JNI 实现二维整型矩阵的转置，重点解析 Get/Release 配对原则、本地引用生命周期、堆内存管理及避免常见 JNI 内存泄漏陷阱。
本文详解如何在 android 原生开发中安全、高效地通过 jni 实现二维整型矩阵的转置，重点解析 `get/release` 配对原则、本地引用生命周期、堆内存管理及避免常见 jni 内存泄漏陷阱。
在 Android 原生开发中，通过 JNI 在 Java 与 C++ 之间传递二维数组（如 int[][]）是一项高频但易出错的操作。核心挑战不在于算法逻辑（转置本身仅需行列索引互换），而在于 JNI 本地引用管理 和 C++ 手动内存生命周期控制 的协同——二者处理不当将导致崩溃、数据错乱或静默内存泄漏。
✅ 正确做法：分阶段管理本地引用，延迟释放，避免提前解绑
原实现中注释掉的 env->ReleaseIntArrayElements(..., JNI_ABORT) 是关键隐患点：GetIntArrayElements() 返回的是 JVM 堆内存的直接指针（可能为拷贝副本），而 JNI_ABORT 表示“放弃所有修改，丢弃副本”，这会破坏后续读取行为；更严重的是，在未完成读取前就调用 Release，会导致后续访问 row_elements[i][j] 时读取已失效内存 —— 这正是启用该行后结果错误的根本原因。
✅ 正确策略是：所有 GetXXXElements() 获取的指针，必须在其对应数据被完整读取/写入后，再统一 Release。且应使用 JNI_COMMIT（确保修改同步回 Java 数组）或 JNI_ABORT（仅用于只读场景且明确放弃修改），但本例为纯读取，推荐 JNI_COMMIT 或更安全的 0（等价于 JNI_COMMIT）：
// ✅ 正确：先完整读取所有原始数据，再批量释放
jint **row_elements = new jint*[row];
jintArray* input_rows = new jintArray[row]; // 缓存 local ref，便于后续释放
for (jsize i = 0; i GetObjectArrayElement(arr, i);
row_elements[i] = env->GetIntArrayElements(input_rows[i], nullptr);
}
// 执行转置计算（此时所有 row_elements[i] 均有效）
jint **transposed = new jint*[column];
for (jsize i = 0; i ReleaseIntArrayElements(input_rows[i], row_elements[i], JNI_ABORT); // 只读，用 JNI_ABORT
env->DeleteLocalRef(input_rows[i]); // 显式删除 local ref，释放 slot
}
// 构造返回结果（无 Get 操作，无需 Release）
jclass intArrayClass = env->FindClass("[I");
jobjectArray result = env->NewObjectArray(column, intArrayClass, nullptr);
for (jsize i = 0; i NewIntArray(row);
env->SetIntArrayRegion(rowArr, 0, row, transposed[i]);
env->SetObjectArrayElement(result, i, rowArr);
env->DeleteLocalRef(rowArr); // ✅ 必须释放！NewIntArray 创建了新 local ref
}
// 清理 C++ 堆内存
for (jsize i = 0; i <h3>⚠️ 关键注意事项与最佳实践</h3>
本地引用（Local Reference）不是无限的：每个 JNI 函数调用拥有固定大小的本地引用表（通常 512~4096 slots）。GetObjectArrayElement、NewIntArray、FindClass 等均占用 slot。若循环中未及时 DeleteLocalRef，极易触发 java.lang.OutOfMemoryError: Failed to allocate a ... byte allocation with ... free bytes and ... free memory。
-
ReleaseXXXElements 的时机决定正确性：
- Get 后立即 Release → 指针失效 → 未定义行为（崩溃/乱码）
- Get 后在所有读取完成后 Release → ✅ 安全
- 不 Release → 仅泄漏本地引用（JVM 自动回收，但大量循环下仍会耗尽 slot）
NewXXX 对象必须 DeleteLocalRef：
NewIntArray、NewObjectArray、FindClass 返回的都是 local ref，必须显式 DeleteLocalRef（除非立即返回给 Java）。上例中 rowArr 和 input_rows[i] 均需释放。C++ new[] / delete[] 与 JNI 无关，但必须配对：
JNIEnv 方法（如 NewIntArray）分配的是 Java 堆内存，由 GC 管理；而 new jint*[row] 分配的是 C++ 堆内存，必须手动 delete[]，否则造成 native heap 泄漏。这是 C++ 语言规则，在 Android NDK 中同样严格适用。性能优化建议：
对于大矩阵，避免逐行 GetObjectArrayElement（产生 row 次 JNI 调用）。可改用一维 int[] 传入 + row/col 参数，用 GetIntArrayElements 一次性获取全部数据，再按 data[i * col + j] 访问，显著减少 JNI 开销。
✅ 总结：三原则保障 JNI 稳健性
- 引用守恒原则：每次 Get / New / Find 后，若不再需要该引用，必须 DeleteLocalRef 或 ReleaseXXXElements。
- 操作原子原则：GetXXXElements 与 ReleaseXXXElements 必须成对，且 Release 发生在数据访问完成之后。
- 内存分离原则：Java 堆对象交由 GC；C++ 堆对象（new）必须 delete；JNI 本地引用（local ref）必须 DeleteLocalRef。
遵循以上实践，你的 JNI 矩阵转置函数将兼具正确性、健壮性与可维护性，为更复杂的原生计算打下坚实基础。
