Flutter中使用Android存储访问框架(SAF)：重复请求文件夹权限问题

核心问题在于未持久化保存已授权的文件夹Uri——SAF的访问权限是与特定Uri绑定的，应用重启或下次访问时，如果没有恢复之前保存的授权Uri，就会触发重新请求。以下是可落地的解决步骤：

• 授权成功后立即保存Uri
  当用户首次完成文件夹授权后，将返回的Uri字符串持久化存储（比如用SharedPreferences）：

  // 调用SAF授权并获取Uri
  final String? authorizedUri = await Saf.openDocumentTree(persistable: true);
  if (authorizedUri != null) {
    // 保存到本地存储
    final prefs = await SharedPreferences.getInstance();
    await prefs.setString('saved_folder_uri', authorizedUri);
  }
  

  注意必须显式设置persistable: true，确保系统允许持久化该授权。

• 启动/访问前恢复授权
  每次需要访问文件夹时，先从本地读取保存的Uri，尝试恢复权限：

  final prefs = await SharedPreferences.getInstance();
  final String? savedUri = prefs.getString('saved_folder_uri');
  
  if (savedUri != null) {
    // 尝试恢复已授权的Uri
    bool isRestored = await Saf.restorePersistedUri(savedUri);
    if (isRestored) {
      // 权限恢复成功，直接执行文件夹读取操作
      await Saf.listFiles(savedUri);
    } else {
      // 恢复失败（如用户手动撤销权限），重新请求授权
      final String? newUri = await Saf.openDocumentTree(persistable: true);
      if (newUri != null) {
        await prefs.setString('saved_folder_uri', newUri);
      }
    }
  } else {
    // 无保存的Uri，首次请求授权
    final String? newUri = await Saf.openDocumentTree(persistable: true);
    if (newUri != null) {
      await prefs.setString('saved_folder_uri', newUri);
    }
  }
  

• 排查系统级限制
  部分Android设备的隐私设置会自动重置应用权限，比如开启了「自动重置应用权限」功能。需要引导用户前往系统设置，找到对应应用，关闭该选项，避免系统清除SAF的持久化授权数据。

• 额外注意事项

  • SAF授权与普通的READ_EXTERNAL_STORAGE权限无关，无需申请这类传统存储权限
  • 保存的Uri仅对当前应用有效，无法跨应用复用
  • 如果用户手动删除了授权文件夹或在系统设置中撤销了应用对该文件夹的访问权限，保存的Uri会失效，需重新请求授权

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