借助Android SAF更新Google Drive文件的技术问题咨询

一、修复SAF写入权限问题（解决安全异常） #

你遇到的安全异常，核心原因是没有获取持久化的写入权限。用ACTION_OPEN_DOCUMENT获取的Uri默认是临时权限，应用重启或一段时间后会失效，且默认可能未包含写入权限。解决步骤：

1. 启动文件选择器时申请持久化读写权限
   启动ACTION_OPEN_DOCUMENT时，添加以下flags确保获取可持久化的读写权限：

   Intent intent = new Intent(Intent.ACTION_OPEN_DOCUMENT);
   intent.addCategory(Intent.CATEGORY_OPENABLE);
   intent.setType("*/*"); // 根据你的文件类型调整
   // 申请临时读写权限，并允许持久化保存
   intent.addFlags(Intent.FLAG_GRANT_WRITE_URI_PERMISSION);
   intent.addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION);
   intent.addFlags(Intent.FLAG_GRANT_PERSISTABLE_URI_PERMISSION);
   startActivityForResult(intent, REQUEST_CODE_OPEN_DOC);
   

2. 在回调中保存持久化权限
   在onActivityResult（或Activity Result API的回调）中，获取返回的Uri后，调用takePersistableUriPermission将权限持久化：

   @Override
   protected void onActivityResult(int requestCode, int resultCode, Intent data) {
       super.onActivityResult(requestCode, resultCode, data);
       if (requestCode == REQUEST_CODE_OPEN_DOC && resultCode == RESULT_OK) {
           Uri originalUri = data.getData();
           if (originalUri != null) {
               // 保存Uri到SharedPreferences备用
               saveUriToPrefs(originalUri);
               // 持久化权限
               getContentResolver().takePersistableUriPermission(
                   originalUri,
                   Intent.FLAG_GRANT_READ_URI_PERMISSION | Intent.FLAG_GRANT_WRITE_URI_PERMISSION
               );
           }
       }
   }
   

3. 写入修改后的文件到原Uri
   之后需要写回时，直接用保存的Uri打开输出流即可：

   Uri savedUri = getUriFromPrefs();
   try (OutputStream outputStream = getContentResolver().openOutputStream(savedUri)) {
       // 将修改后的文件内容写入outputStream
       // 示例：从内部存储读取修改后的文件，写入输出流
       File modifiedFile = new File(getFilesDir(), "modified_file.txt");
       Files.copy(modifiedFile.toPath(), outputStream);
   } catch (IOException e) {
       e.printStackTrace();
   }
   

二、优化重新选择文件的体验（可选） #

如果无法使用持久化权限，想让用户重新选择原文件时定位到目标位置，可以：

• 第一次选择时保存原文件的父文件夹Uri（通过DocumentFile.fromSingleUri(this, originalUri).getParentFile()获取），后续启动选择器时用EXTRA_INITIAL_URI指定初始路径：

  Intent intent = new Intent(Intent.ACTION_OPEN_DOCUMENT);
   intent.addCategory(Intent.CATEGORY_OPENABLE);
   intent.setType("*/*");
   // 设置初始文件夹为原文件所在目录
   Uri parentFolderUri = getParentFolderUriFromPrefs();
   if (parentFolderUri != null) {
       intent.putExtra(DocumentsContract.EXTRA_INITIAL_URI, parentFolderUri);
   }
   startActivityForResult(intent, REQUEST_CODE_REOPEN_DOC);
  

  这样选择器会直接打开原文件所在的Google Drive文件夹，提升用户体验。

三、关于Google Drive REST API的说明 #

集成Drive API时，只要申请drive.file权限（而非仅drive.appdata），用户授权后，应用可以访问用户明确授权的任何文件（包括非应用创建的），发布后权限范围不会自动改变，只要你在Google Cloud Console中配置的OAuth 2.0权限正确即可。不过这种方式需要处理OAuth授权流程，比SAF更复杂，适合需要深度Drive集成的场景。

其他可选方式 #

如果你的场景允许覆盖原文件，还可以尝试：

• 第一次选择时使用ACTION_EDIT而非ACTION_OPEN_DOCUMENT，直接获取可编辑的Uri，但该Intent的支持度不如ACTION_OPEN_DOCUMENT广泛，需测试不同版本的Google Drive客户端。

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