Android 13+下Jetpack Compose应用操作外部SQLite数据库权限求助

针对Android 13下无法通过传统存储权限访问下载文件夹中SQLite文件的问题，以下是两种可行方案，优先推荐官方规范的存储访问框架（SAF）：

方案一：存储访问框架(SAF) 推荐 #

Android 10+官方推荐使用SAF访问共享存储中的非媒体文件，无需申请传统读写权限，通过系统文件选择器让用户主动授权文件访问。

1. 启动文件选择器获取数据库Uri #

在Jetpack Compose中使用rememberLauncherForActivityResult注册文件选择回调：

val pickFileLauncher = rememberLauncherForActivityResult(
    contract = ActivityResultContracts.OpenDocument()
) { uri: Uri? ->
    uri?.let { selectedUri ->
        // 拿到用户选择的数据库文件Uri，执行后续操作
        handleSqliteFile(selectedUri, context)
    }
}

// 触发选择的按钮
Button(onClick = {
    // 指定SQLite文件的MIME类型，过滤无关文件
    pickFileLauncher.launch(arrayOf("application/x-sqlite3"))
}) {
    Text("选择SQLite数据库")
}

2. 操作SQLite数据库 #

由于SAF返回的Uri无法直接用文件路径访问，建议先将文件复制到应用私有目录，再进行常规数据库操作：

private fun handleSqliteFile(uri: Uri, context: Context) {
    val inputStream = context.contentResolver.openInputStream(uri) ?: return
    // 应用私有目录，无需额外权限
    val tempDbFile = File(context.filesDir, "temp_db_copy.sqlite")

    // 复制文件到私有目录
    inputStream.use { input ->
        FileOutputStream(tempDbFile).use { output ->
            input.copyTo(output)
        }
    }

    // 常规SQLite操作示例
    val db = SQLiteDatabase.openOrCreateDatabase(tempDbFile, null)
    // 执行查询、插入、更新等操作
    val cursor = db.rawQuery("SELECT * FROM your_table", null)
    // 处理查询结果...
    cursor.close()
    db.close()
}

3. 删除原下载文件 #

通过SAF获取Uri后，先持久化权限（可选，避免下次操作重新选择），再调用ContentResolver删除文件：

// 持久化读写权限
context.contentResolver.takePersistableUriPermission(
    uri,
    Intent.FLAG_GRANT_READ_URI_PERMISSION or Intent.FLAG_GRANT_WRITE_URI_PERMISSION
)

// 删除原文件
val deletedRows = context.contentResolver.delete(uri, null, null)
if (deletedRows > 0) {
    // 删除成功
}

方案二：MANAGE_EXTERNAL_STORAGE权限 不推荐 #

仅适用于文件管理器类等需要全存储访问的应用，Google Play审核会严格限制，非必要不使用。

1. 声明权限 #

在AndroidManifest.xml中添加：

<uses-permission android:name="android.permission.MANAGE_EXTERNAL_STORAGE"
    android:minSdkVersion="30" />
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"
    android:maxSdkVersion="32" />

2. 请求权限 #

在Compose中引导用户开启全存储访问：

val context = LocalContext.current
Button(onClick = {
    if (Environment.isExternalStorageManager()) {
        // 已授权，直接访问下载文件夹
        val downloadDir = Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_DOWNLOADS)
        val dbFile = File(downloadDir, "target_db.sqlite")
        // 执行数据库操作...
    } else {
        // 跳转系统设置开启权限
        val intent = Intent(Settings.ACTION_MANAGE_APP_ALL_FILES_ACCESS_PERMISSION)
        intent.data = Uri.parse("package:${context.packageName}")
        context.startActivity(intent)
    }
}) {
    Text("请求全存储访问权限")
}

关键提示 #

• Android 13中READ_MEDIA_*系列权限仅对图片、视频、音频生效，无法访问SQLite这类文档文件。
• SAF方案符合隐私规范，用户授权流程透明，不会影响应用上架。
• 复制文件到私有目录可提升数据库操作性能，避免频繁访问ContentResolver的IO开销。

内容的提问来源于stack exchange，提问作者Vitor Moreira