Android 11 OPEN_DOCUMENT获取的URI偶现无权限报错问题咨询

核心授权规则 #

• 持久化URI权限的生效前提：调用ACTION_OPEN_DOCUMENT获取用户选中文件的URI后，必须主动调用getContentResolver().takePersistableUriPermission(uri, Intent.FLAG_GRANT_READ_URI_PERMISSION | Intent.FLAG_GRANT_WRITE_URI_PERMISSION)才能拿到跨重启的持久化权限，仅靠启动Intent时携带的flags无法自动获得持久化权限，默认返回的临时权限仅在当前Activity生命周期内有效。
• 持久化权限配额限制：这是批量上传到一半出现权限报错的核心原因，Android系统对单个应用可持有的持久化URI授权数量有固定配额，不同厂商底层设置的阈值不同，普遍在500~1000区间，超过阈值后系统会自动回收最早授予的持久化权限，就会触发SecurityException: Permission Denial类的未授权错误。
• 权限作用范围：单文件的持久化权限仅针对选中的单条URI生效，不包含对应目录下的其他文件，跨用户、跨应用默认不共享，设备加密锁未解锁时（开机后第一次解锁前）无法访问对应URI。
• 权限主动失效场景：原始文件被删除、对应的存储卷被卸载（比如SD卡拔出）、用户手动清除了应用的存储权限、系统恢复出厂设置，都会导致已持有的URI权限直接失效。

批量上传场景的报错解决方案 #

• 优先调整业务逻辑，避免一次性申请上千个文件的持久化权限，用户选中文件后先把文件拷贝到应用专属沙盒目录（context.getFilesDir()/context.getExternalFilesDir()），后续直接操作沙盒内的本地文件，不需要持有URI权限，也完全不会触发配额限制。
• 如果业务必须留存原始URI，批量操作前可以调用getContentResolver().getPersistedUriPermissions()查询当前应用已持有的有效权限列表，提前过滤掉已被系统回收的URI，避免运行时抛出异常。
• 针对已被回收权限的URI，可以引导用户通过ACTION_OPEN_DOCUMENT_TREE选中对应文件所在的父目录，申请目录级的持久化权限，单条目录权限可以访问目录下所有文件，不受单文件配额限制。
• 如果上传任务可以在应用进程存活期间完成，临时批量操作场景可以不用申请持久化权限，直接使用Intent返回的临时权限，临时权限的配额比持久化权限高很多，不会轻易触发回收。

权限有效性校验代码示例 #

// 校验URI是否具备可读权限
public boolean checkUriReadPermission(Context context, Uri uri) {
    int checkResult = context.checkCallingOrSelfUriPermission(uri, Intent.FLAG_GRANT_READ_URI_PERMISSION);
    return checkResult == PackageManager.PERMISSION_GRANTED;
}

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