Android JNI开发实战：如何安全高效地调用.so文件中的函数

1次阅读

共计 3122 个字符，预计需要花费 8 分钟才能阅读完成。

在 Android 开发中，.so（Shared Object）文件作为动态链接库，常用于以下场景：

复用 C /C++ 高性能计算代码（如图像处理、加密算法）
集成第三方闭源 SDK（如人脸识别引擎）
突破 Java 层内存限制（如大规模矩阵运算）

符号解析失败：
现象：java.lang.UnsatisfiedLinkError: No implementation found for...
原因：C++ 函数名混淆（name mangling）或签名不匹配
内存泄漏：
未释放 JNI 局部引用（LocalRef）导致局部引用表溢出
GlobalRef 未手动释放造成永久泄漏
线程安全问题：
跨线程错误使用同一 JNIEnv 指针
未同步访问 Native 层全局变量
类型转换错误：
Java 数组与 C 数组转换时长度处理不当
未处理 UTF- 8 与 UTF-16 字符串差异
异常处理缺失：
Native 代码未检查 Java 异常（ExceptionOccurred）
未正确处理 OOM 等临界场景

System.loadLibrary(“foo”)：
自动补全 lib 前缀和.so 后缀（实际加载 libfoo.so）
依赖系统库搜索路径（如/data/app-lib/ 包名 /）
System.load(“/abs/path/libbar.so”)：
需指定完整路径
常用于插件化动态加载

// Java 声明
public native void nativeProcess(byte[] data);

// C++ 实现（需严格匹配签名）extern "C" JNIEXPORT void JNICALL
Java_com_example_NativeLib_nativeProcess(JNIEnv* env, jobject thiz, jbyteArray data) {// 实现代码}

// 在 JNI_OnLoad 中注册
JNIEXPORT jint JNI_OnLoad(JavaVM* vm, void* reserved) {
    JNIEnv* env;
    vm->GetEnv((void**)&env, JNI_VERSION_1_6);

    JNINativeMethod methods[] = {{"nativeProcess", "([B)V", (void*)nativeProcessImpl}
    };

    env->RegisterNatives(env->FindClass("com/example/NativeLib"), 
                        methods, sizeof(methods)/sizeof(JNINativeMethod));
    return JNI_VERSION_1_6;
}

void safeCallTemplate(JNIEnv* env, jobject obj) {
    // 1. 检查异常
    if (env->ExceptionCheck()) {env->ExceptionDescribe();
        env->ExceptionClear();
        return;
    }

    // 2. 局部引用自动管理
    jclass clazz = env->GetObjectClass(obj);
    if (!clazz) return;

    // 3. 使用 DeleteLocalRef 释放（非必须但建议）env->DeleteLocalRef(clazz);
}

public class NativeWrapper {
    static {System.loadLibrary("native-lib");
    }

    // 带异常抛出的 Native 方法
    public native String processData(byte[] input) throws NativeException;
}

// native-lib.cpp
#include <jni.h>
#include <string>

extern "C" {
    JNIEXPORT jstring JNICALL 
    processDataImpl(JNIEnv* env, jobject thiz, jbyteArray input) {
        // 1. 检查输入
        if (!input) {jclass exCls = env->FindClass("com/example/NativeException");
            env->ThrowNew(exCls, "Input cannot be null");
            return nullptr;
        }

        // 2. 安全转换
        jbyte* bytes = env->GetByteArrayElements(input, nullptr);
        jsize length = env->GetArrayLength(input);

        // 3. 业务处理（示例：Base64 编码）std::string result = base64Encode(bytes, length);

        // 4. 释放资源
        env->ReleaseByteArrayElements(input, bytes, JNI_ABORT);

        return env->NewStringUTF(result.c_str());
    }

    // 动态注册表
    static JNINativeMethod methods[] = {{"processData", "([B)Ljava/lang/String;", (void*)processDataImpl}
    };

    JNIEXPORT jint JNICALL JNI_OnLoad(JavaVM* vm, void* reserved) {
        JNIEnv* env;
        if (vm->GetEnv((void**)&env, JNI_VERSION_1_6) != JNI_OK) {return JNI_ERR;}

        jclass clazz = env->FindClass("com/example/NativeWrapper");
        env->RegisterNatives(clazz, methods, 1);
        env->DeleteLocalRef(clazz);

        return JNI_VERSION_1_6;
    }
}