Android平台下如何在Rust中调用Java的Keystore类API实现安全数据存储？

阿华AIGC实验室

2026-4-17

我来帮你梳理下在Rust静态库中调用Android Keystore API的具体步骤，结合你已经用到的ndk_context和jni crate，咱们一步步推进：

首先，你已经成功完成了最基础的JNI环境初始化——获取Android上下文、绑定JavaVM并附加当前线程，接下来就是对接Keystore相关的Java API了。我基于你的现有代码扩展出完整的示例，同时给你点明关键注意事项：

完整代码示例

use log::info;
use jni::{objects::JObject, sys::jobject, errors::Error};

pub fn try_jni_call() -> Result<(), Error> {
    info!("mark0!");
    let android_context = ndk_context::android_context();
    info!("mark1!");
    let vm = unsafe { jni::JavaVM::from_raw(android_context.vm().cast()) }?;
    info!("mark2!");
    let mut env = vm.attach_current_thread()?;
    info!("mark3!");

    // 1. 把原生Context指针转换成JNI可操作的JObject
    let context_obj = unsafe { JObject::from_raw(android_context.context() as jobject) };
    info!("成功获取Android Context实例");

    // 2. 获取KeyStore核心类引用
    // 加载java.security.KeyStore类
    let key_store_class = env.find_class("java/security/KeyStore")?;
    // 获取AndroidKeyStore类型的KeyStore实例
    let key_store = env.call_static_object_method(
        key_store_class,
        "getInstance",
        "(Ljava/lang/String;)Ljava/security/KeyStore;",
        &[env.new_string("AndroidKeyStore")?.into()],
    )?;

    // 3. 初始化KeyStore（传入null表示使用默认参数）
    env.call_object_method(
        key_store,
        "load",
        "(Ljava/security/KeyStore$LoadStoreParameter;)V",
        &[JObject::null().into()],
    )?;
    info!("KeyStore初始化完成");

    // 4. 示例：检查指定别名的密钥是否存在
    let key_alias = env.new_string("my_app_secure_key")?;
    let key_exists = env.call_boolean_method(
        key_store,
        "containsAlias",
        "(Ljava/lang/String;)Z",
        &[key_alias.into()],
    )?;
    info!("别名[my_app_secure_key]的密钥是否存在：{}", key_exists);

    // 你可以继续扩展：生成密钥、加密/解密数据等操作
    // 比如生成AES密钥的逻辑，需要调用KeyGenerator类的API，步骤类似上述流程

    Ok(())
}

关键注意事项

方法签名必须精准：JNI调用Java方法时，必须传入正确的方法签名（比如(Ljava/lang/String;)Ljava/security/KeyStore;）。如果不确定签名，可以用Android SDK自带的javap -s命令生成，比如执行javap -s java.security.KeyStore就能看到所有方法的签名。
异常处理不能忘：JNI调用可能抛出Java层异常，建议在每次调用后用env.exception_check()检查，如果有异常，用env.exception_clear()清理并转换成Rust的错误返回，避免程序崩溃。
引用管理要留心：JNI的局部引用会在线程 detach 时自动释放，但如果需要长期持有某个对象（比如Context或KeyStore实例），要调用env.new_global_ref()转换成全局引用，用完后记得用env.delete_global_ref()释放，防止内存泄漏。
线程附加规则：如果你的Rust代码在后台线程执行，每次调用JNI前都需要附加线程到JavaVM，用完后可以调用vm.detach_current_thread() detach，但如果是频繁调用的线程，保持附加状态会更高效。