Android 11下CSV日志文件访问异常：如何实现用户可靠获取数据？

核心原因 #

你遇到的问题本质是Android 11的Scoped Storage机制与MTP（USB文件传输）的文件状态同步冲突：

• 即使开启requestLegacyExternalStorage，Android 11对共享存储的访问仍受Scoped Storage约束，File API依赖的本地文件系统状态和系统MediaStore数据库会出现异步延迟，导致Windows操作文件后，Android端拿到的是缓存的旧状态。
• 通过MTP复制回的文件，其权限不属于你的应用，因此canWrite()返回false，无法修改或删除。

不推荐使用All Files Access/Manage External Storage #

除非你的应用是专业文件管理器类应用，否则不要申请这两个权限：

• MANAGE_EXTERNAL_STORAGE需要Google Play特殊审核，通过率极低，且违反Scoped Storage的设计初衷。
• 这两个权限会带来不必要的权限风险，完全可以通过合规方式解决问题。

可靠解决方案 #

1. 改用MediaStore API管理共享存储文件 #

放弃直接使用File类，通过ContentResolver操作MediaStore，确保和系统文件状态实时同步：

示例：查询并删除指定CSV文件

fun deleteCsvFile(context: Context, fileName: String) {
    val projection = arrayOf(MediaStore.Files.FileColumns._ID)
    val selection = "${MediaStore.Files.FileColumns.DISPLAY_NAME} = ? AND ${MediaStore.Files.FileColumns.RELATIVE_PATH} = ?"
    val selectionArgs = arrayOf(fileName, "Documents/layline/")
    
    context.contentResolver.query(
        MediaStore.Files.getContentUri("external"),
        projection,
        selection,
        selectionArgs,
        null
    )?.use { cursor ->
        if (cursor.moveToFirst()) {
            val id = cursor.getLong(cursor.getColumnIndexOrThrow(MediaStore.Files.FileColumns._ID))
            val uri = ContentUris.withAppendedId(MediaStore.Files.getContentUri("external"), id)
            context.contentResolver.delete(uri, null, null)
        }
    }
}

示例：创建/写入CSV文件

fun writeCsvToDocuments(context: Context, fileName: String, content: String) {
    val values = ContentValues().apply {
        put(MediaStore.Files.FileColumns.DISPLAY_NAME, fileName)
        put(MediaStore.Files.FileColumns.RELATIVE_PATH, "Documents/layline/")
        put(MediaStore.Files.FileColumns.MIME_TYPE, "text/csv")
        put(MediaStore.Files.FileColumns.IS_PENDING, 1)
    }

    val uri = context.contentResolver.insert(MediaStore.Files.getContentUri("external"), values)
    uri?.let {
        context.contentResolver.openOutputStream(it).use { outputStream ->
            outputStream?.write(content.toByteArray())
        }
        values.clear()
        values.put(MediaStore.Files.FileColumns.IS_PENDING, 0)
        context.contentResolver.update(uri, values, null, null)
    }
}

2. 使用Storage Access Framework (SAF)让用户选择存储目录 #

通过SAF让用户手动选择layline目录，应用将获得该目录的持久读写权限，无论用户通过MTP如何操作文件，应用都能正常访问：

示例：请求目录权限

private val REQUEST_CODE_PICK_DIR = 1001

fun requestDirectoryPermission(activity: Activity) {
    val intent = Intent(Intent.ACTION_OPEN_DOCUMENT_TREE)
    activity.startActivityForResult(intent, REQUEST_CODE_PICK_DIR)
}

// 在Activity的onActivityResult中处理结果
override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent?) {
    super.onActivityResult(requestCode, resultCode, data)
    if (requestCode == REQUEST_CODE_PICK_DIR && resultCode == Activity.RESULT_OK) {
        data?.data?.let { treeUri ->
            // 持久化权限
            contentResolver.takePersistableUriPermission(
                treeUri,
                Intent.FLAG_GRANT_READ_URI_PERMISSION or Intent.FLAG_GRANT_WRITE_URI_PERMISSION
            )
            // 后续通过DocumentFile操作该目录下的文件
            val directory = DocumentFile.fromTreeUri(this, treeUri)
            directory?.createFile("text/csv", "log.csv")?.let { file ->
                // 写入文件
                contentResolver.openOutputStream(file.uri).use { outputStream ->
                    outputStream?.write("data1,data2\n".toByteArray())
                }
            }
        }
    }
}

3. 备选方案：私有目录+导出功能 #

如果不需要用户实时通过Windows访问文件，可以将日志保存在应用私有目录（context.filesDir或context.getExternalFilesDir(null)），然后提供导出功能：

• 私有目录的文件只有应用能访问，不会出现权限同步问题。
• 当用户需要获取日志时，通过应用将文件复制到Documents目录，或通过分享功能（如邮件、USB共享）发送给用户。

关键注意事项 #

• 移除requestLegacyExternalStorage属性，完全适配Scoped Storage，避免后续版本的兼容性问题。
• 所有文件操作都通过ContentResolver或DocumentFile执行，不再依赖File类的状态判断（如exists()、canWrite()）。

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