Android 11环境下Scoped Storage应用调用MS Word编辑文件后出现文件访问权限异常问题排查

这个问题我之前处理过，本质是Android 11（API 30）Scoped Storage机制下，不同第三方应用对MediaStore文件的编辑规范差异导致的，咱们一步步拆解原因和解决办法：

核心原因分析 #

1. Scoped Storage的权限逻辑：当你通过MediaStore.Downloads插入文件后，你的应用会获得该文件的持久化访问权限，但这个权限的维持依赖于其他编辑应用是否遵循MediaStore的规范来修改文件。
2. MS Word的特殊处理：在Android 11上，Word编辑MediaStore中的文件时，没有采用ContentResolver.openFileDescriptor()配合MODE_WRITE/MODE_READ_WRITE的合规方式修改文件，而是直接替换了原文件或修改了文件的权限属性，导致系统判定你的应用不再拥有该文件的访问权限，于是抛出SecurityException。
3. WPS等应用的合规性：WPS这类应用严格遵循MediaStore的API规范，通过ContentResolver接口编辑文件，不会改变文件的权限归属，所以你的应用的持久化权限得以保留，在Android 10和11上都能正常访问。
4. Android 10的兼容性：Android 10虽然引入了Scoped Storage，但默认允许应用通过requestLegacyExternalStorage=true启用传统存储访问（即使targetSdkVersion=30，这个flag在Android 10上依然生效），所以即使Word修改了文件，你的应用依然能通过传统路径访问，不会触发权限问题。

可行的解决方案 #

1. 编辑前获取持久化URI权限 #

在启动编辑Intent之前，主动调用takePersistableUriPermission()获取文件的持久化权限，确保文件被修改后你的应用依然能访问：

// 启动编辑Intent前执行
contentResolver.takePersistableUriPermission(
    uri,
    Intent.FLAG_GRANT_READ_URI_PERMISSION or Intent.FLAG_GRANT_WRITE_URI_PERMISSION
)

注意：调用这个方法的前提是你的应用已经拥有该URI的临时权限（通常通过MediaStore插入文件时自动获得），否则会抛出异常。

2. 编辑后重新获取访问权限 #

如果遇到SecurityException，可以尝试通过openFileDescriptor()重新获取权限，或者重新查询MediaStore获取文件的最新URI：

try {
    contentResolver.openFileDescriptor(uri, "r")?.use {
        // 在这里处理文件访问逻辑
    }
} catch (e: SecurityException) {
    // 权限丢失，重新查询MediaStore获取最新URI
    val cursor = contentResolver.query(
        uri,
        arrayOf(MediaStore.Downloads._ID),
        null,
        null,
        null
    )
    cursor?.use {
        if (it.moveToFirst()) {
            val newUri = ContentUris.withAppendedId(
                MediaStore.Downloads.getContentUri(MediaStore.VOLUME_EXTERNAL_PRIMARY),
                it.getLong(0)
            )
            // 使用newUri重新尝试访问文件
        }
    }
}

3. 引导用户重新授权 #

如果上述方法都失效，可以引导用户通过系统文件选择器重新选择该文件，这样你的应用会获得新的临时权限，之后再转为持久化权限即可。

4. 改用应用专属目录（推荐） #

如果你的文件不需要被其他应用访问，建议将文件保存到应用专属目录（比如context.filesDir或context.getExternalFilesDir(null)），这类目录不受Scoped Storage权限限制，也不会出现其他应用修改后权限丢失的问题。

内容的提问来源于stack exchange，提问作者Serhii K.