Android通过JNI(C/C++)创建SQLite3数据库失败求助

问题场景 #

在React Native的Android平台，通过JNI调用C/C++代码创建SQLite3数据库时，数据库文件无法生成，报错Could not create db。已配置Manifest权限并完成JNI关联，但React Native中无READ_INTERNAL_STORAGE权限选项，需定位遗漏点并解决。

核心问题与解决方案 #

1. 权限逻辑修正 #

权限配置冗余与错误

• READ_INTERNAL_STORAGE属于系统默认权限，无需在Manifest中声明，也不需要申请。
• Android 11（API 30）及以上，直接写入公共Download目录需要MANAGE_EXTERNAL_STORAGE权限，该权限无法通过普通requestMultiple申请，需引导用户到应用设置手动开启。
• 原React Native权限判断逻辑错误：当前写法仅校验第三个权限为granted，前两个权限只要存在就通过，需修正为所有权限都必须是granted。

修正后的权限申请代码

import { Platform, PermissionsAndroid, IntentAndroid, PackageInfo } from 'react-native';

const requestStoragePermissions = async () => {
  try {
    // 申请普通存储权限
    const normalPermResult = await PermissionsAndroid.requestMultiple([
      PermissionsAndroid.PERMISSIONS.WRITE_EXTERNAL_STORAGE,
      PermissionsAndroid.PERMISSIONS.READ_EXTERNAL_STORAGE,
      PermissionsAndroid.PERMISSIONS.ACCESS_MEDIA_LOCATION,
    ]);

    // 检查所有普通权限是否授予
    const allNormalGranted = Object.values(normalPermResult).every(perm => perm === 'granted');
    if (!allNormalGranted) {
      console.log("部分存储权限未授予");
      return false;
    }

    // Android 11+ 检查特殊存储权限
    if (Platform.Version >= 30) {
      const hasManagePerm = await PermissionsAndroid.check(PermissionsAndroid.PERMISSIONS.MANAGE_EXTERNAL_STORAGE);
      if (!hasManagePerm) {
        // 引导用户到设置页开启权限
        await IntentAndroid.startActivityForResult(
          IntentAndroid.createIntent(
            'android.settings.MANAGE_APP_ALL_FILES_ACCESS_PERMISSION',
            `package:${PackageInfo.packageName}`
          ),
          1001
        );
      }
    }
    return true;
  } catch (err) {
    console.warn("权限申请失败：", err);
    return false;
  }
};

2. 避免硬编码文件路径 #

硬编码/storage/emulated/0/Download/存在设备兼容性问题，应通过原生API获取合法路径，再传递给JNI层：

步骤1：修改Java层Native方法，接收路径参数

public class SQLiteDB {
    static {
        System.loadLibrary("sqlite-db");
    }

    // 修改方法，接收数据库路径参数
    public native void initDb(String dbPath);
}

步骤2：修改JNI层代码，使用传递的路径

#include <jni.h>
#include <android/log.h>
#include <sqlite3.h>

#define LOG_TAG "MyApp"
#define LOGE(...) __android_log_print(ANDROID_LOG_ERROR, LOG_TAG, __VA_ARGS__)
#define LOGI(...) __android_log_print(ANDROID_LOG_INFO, LOG_TAG, __VA_ARGS__)

void createDb(const char* dbPath) {
    sqlite3 *db;
    int rc;

    rc = sqlite3_open(dbPath, &db);

    if (rc) {
        LOGE("Can't open database: %s", sqlite3_errmsg(db));
    } else {
        LOGI("Opened database successfully");
        // 可在此添加创建表等初始化逻辑
    }
    // 必须关闭数据库句柄，避免资源泄漏
    sqlite3_close(db);
}

extern "C"
JNIEXPORT void JNICALL
Java_com_example_SQLiteDB_initDb(JNIEnv *env, jobject instance, jstring db_path) {
    const char* path = env->GetStringUTFChars(db_path, nullptr);
    createDb(path);
    env->ReleaseStringUTFChars(db_path, path);
}

步骤3：React Native层获取合法路径并调用

import { Platform, NativeModules } from 'react-native';
import RNFS from 'react-native-fs'; // 需先安装react-native-fs

const SQLiteDB = NativeModules.SQLiteDB;

// 获取公共Download目录路径
const getDbFilePath = async () => {
  if (Platform.OS !== 'android') return '';
  return `${RNFS.DownloadDirectoryPath}/sqlite_lite.db`;
};

// 初始化数据库
const initDatabase = async () => {
  const hasPerm = await requestStoragePermissions();
  if (!hasPerm) return;
  
  const dbPath = await getDbFilePath();
  SQLiteDB.initDb(dbPath);
};

3. 优化错误日志定位 #

原C代码中日志级别错误（成功场景用了ANDROID_LOG_ERROR），且未完全利用sqlite3_errmsg的错误信息，建议修正日志级别，同时确保能捕获到具体错误原因（如权限不足、路径不存在等）。

4. 兼容分区存储（可选） #

如果目标是Android 10（API 29）及以上，可在AndroidManifest.xml的<application>标签添加以下属性，兼容旧版存储模式（临时方案，长期建议适配MediaStore）：

android:requestLegacyExternalStorage="true"

内容的提问来源于stack exchange，提问作者Program-Me-Rev