安卓APP备份恢复权限问题：卸载重装后无法读取备份文件

核心原因 #

卸载重装应用后，之前授予的存储权限会被完全重置，再加上Android 10（API 29）及以上启用的Scoped Storage机制，直接硬编码访问/storage/emulated/0/Downloads这类公共目录会受到严格限制，最终触发EACCES (Permission denied)错误。

具体解决办法 #

1. 优先使用存储访问框架（SAF）读取备份 #

这是Scoped Storage下最合规的方案，不需要申请敏感权限，让用户手动选择备份文件即可：

// 启动文件选择器，默认指向Downloads目录
Intent pickBackupIntent = new Intent(Intent.ACTION_OPEN_DOCUMENT);
pickBackupIntent.addCategory(Intent.CATEGORY_OPENABLE);
pickBackupIntent.setType("application/xml");
// 指定起始目录为系统Downloads
Uri downloadsDirUri = MediaStore.Downloads.EXTERNAL_CONTENT_URI;
pickBackupIntent.putExtra(DocumentsContract.EXTRA_INITIAL_URI, downloadsDirUri);
// 用registerForActivityResult替代旧的startActivityForResult（AndroidX推荐）
ActivityResultLauncher<Intent> pickFileLauncher = registerForActivityResult(
    new ActivityResultContracts.StartActivityForResult(),
    result -> {
        if (result.getResultCode() == RESULT_OK && result.getData() != null) {
            Uri backupUri = result.getData().getData();
            try (InputStream inputStream = getContentResolver().openInputStream(backupUri)) {
                // 将读取到的流写入目标shared_prefs路径
                writeBackupToSharedPrefs(inputStream);
            } catch (IOException e) {
                e.printStackTrace();
            }
        }
    }
);
pickFileLauncher.launch(pickBackupIntent);

2. 若坚持直接路径访问，处理权限重置问题 #

• Android 12及以下：
  在AndroidManifest.xml中声明权限：

  <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
  

  重装应用后，必须重新向用户请求权限：

  if (ContextCompat.checkSelfPermission(this, Manifest.permission.READ_EXTERNAL_STORAGE)
          != PackageManager.PERMISSION_GRANTED) {
      ActivityCompat.requestPermissions(this,
              new String[]{Manifest.permission.READ_EXTERNAL_STORAGE},
              1001); // 自定义请求码
  }
  

• Android 13及以上：
  对于XML这类非媒体文件，直接访问Downloads需要申请MANAGE_EXTERNAL_STORAGE权限（注意：这个权限属于敏感权限，Google Play对其使用有严格限制）：

  1. 在Manifest中添加权限：

     <uses-permission android:name="android.permission.MANAGE_EXTERNAL_STORAGE" />
     

  2. 引导用户到应用设置开启权限：

     Intent permissionIntent = new Intent(Settings.ACTION_MANAGE_APP_ALL_FILES_ACCESS_PERMISSION);
     Uri packageUri = Uri.fromParts("package", getPackageName(), null);
     permissionIntent.setData(packageUri);
     startActivity(permissionIntent);
     

3. 更稳妥的备选方案：改用应用私有存储 #

如果不需要用户手动查看或修改备份文件，建议把备份文件存在应用私有外部存储目录/storage/emulated/0/Android/data/PACKAGE_NAME/files/，通过getExternalFilesDir(null)即可访问，不需要任何额外权限，而且同一签名的应用重装后仍可读取该目录下的文件（卸载应用时文件会被自动删除）。

关键提醒 #

• 卸载重装会清空应用的所有权限状态，必须在恢复备份前重新请求所需权限，不能依赖之前的授权记录。
• Scoped Storage是Android存储的趋势，直接硬编码公共目录路径的兼容性会越来越差，优先用SAF或私有存储方案。

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