Jetpack Compose文件选择器：权限适配与File对象获取问题

核心问题分析 #

1. URI类型错误：ActivityResultContracts.OpenDocument返回的是内容URI（格式为content://），并非真实的文件系统路径。直接调用uri.path得到的是URI的路径段，不是文件在本地存储的真实路径，因此创建File对象会抛出ENOENT错误。
2. 权限冗余：API 33及以上版本，使用SAF（存储访问框架）的OpenDocument不需要申请READ_EXTERNAL_STORAGE或MANAGE_EXTERNAL_STORAGE权限——SAF通过系统弹窗授权单个文件访问，无需全局存储权限。你当前的权限请求完全多余。

解决方案 #

方案1：直接使用输入流处理（推荐，无需复制文件）

利用ContentResolver获取文件输入流，直接用于上传等操作，避免创建File对象的开销：

@Composable
fun FilePicker(onFileSelected: (Uri) -> Unit) {
    val coroutineScope = rememberCoroutineScope()
    val context = LocalContext.current
    
    val filePickerLauncher = rememberLauncherForActivityResult(
        contract = ActivityResultContracts.OpenDocument(),
        onResult = { uri ->
            uri?.let {
                onFileSelected(it)
                coroutineScope.launch(Dispatchers.IO) {
                    context.contentResolver.openInputStream(it)?.use { inputStream ->
                        val fileName = getFileName(context, it)
                        uploadFileToServer(inputStream, fileName)
                    }
                }
            }
        }
    )

    Button(onClick = {
        // 指定PDF类型，避免用户选择无关文件
        filePickerLauncher.launch(arrayOf("application/pdf"))
    }) {
        Text("选择PDF文件")
    }
}

// 从Content URI获取文件名
private fun getFileName(context: Context, uri: Uri): String? {
    context.contentResolver.query(uri, null, null, null, null)?.use { cursor ->
        val nameColumnIndex = cursor.getColumnIndex(android.provider.OpenableColumns.DISPLAY_NAME)
        cursor.moveToFirst()
        return cursor.getString(nameColumnIndex)
    }
    return "unknown_file.pdf"
}

// 修改上传函数，支持输入流参数
private suspend fun uploadFileToServer(inputStream: InputStream, fileName: String?) {
    // 这里实现你的服务器上传逻辑，用inputStream替代File
}

方案2：复制文件到应用私有目录生成File对象

如果你的上传逻辑必须依赖File对象，可以将SAF选中的文件复制到应用私有目录（该目录无需额外权限）：

@Composable
fun FilePicker(onFileSelected: (Uri) -> Unit) {
    val coroutineScope = rememberCoroutineScope()
    val context = LocalContext.current
    
    val filePickerLauncher = rememberLauncherForActivityResult(
        contract = ActivityResultContracts.OpenDocument(),
        onResult = { uri ->
            uri?.let {
                onFileSelected(it)
                coroutineScope.launch(Dispatchers.IO) {
                    val privateFile = copyToPrivateDir(context, it)
                    privateFile?.let { file ->
                        uploadFileToServer(file)
                    }
                }
            }
        }
    )

    Button(onClick = {
        filePickerLauncher.launch(arrayOf("application/pdf"))
    }) {
        Text("选择PDF文件")
    }
}

// 将文件复制到应用私有目录
private fun copyToPrivateDir(context: Context, uri: Uri): File? {
    return try {
        context.contentResolver.openInputStream(uri)?.use { inputStream ->
            val fileName = getFileName(context, uri) ?: "temp_pdf.pdf"
            val targetFile = File(context.filesDir, fileName)
            
            FileOutputStream(targetFile).use { outputStream ->
                inputStream.copyTo(outputStream)
            }
            targetFile
        }
    } catch (e: IOException) {
        e.printStackTrace()
        null
    }
}

// 复用之前的getFileName函数
private fun getFileName(context: Context, uri: Uri): String? {
    context.contentResolver.query(uri, null, null, null, null)?.use { cursor ->
        val nameColumnIndex = cursor.getColumnIndex(android.provider.OpenableColumns.DISPLAY_NAME)
        cursor.moveToFirst()
        return cursor.getString(nameColumnIndex)
    }
    return null
}

关键注意事项 #

• 移除Manifest中多余的READ_EXTERNAL_STORAGE和MANAGE_EXTERNAL_STORAGE权限声明（如果仅使用SAF）。
• 尽量使用方案1，减少文件复制的IO开销；仅在必须依赖File对象时使用方案2。
• 若需要支持多个文件选择，可使用ActivityResultContracts.OpenMultipleDocuments替代OpenDocument。

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