使用ActivityResultContracts.CreateDocument()写入Dropbox文件失败求助

问题分析 #

通过ActivityResultContracts.CreateDocument()获取Dropbox路径的URI后，调用getContentResolver().openOutputStream()返回null，同时日志抛出PathDoesNotExistException，本质是Dropbox的Documents Provider在创建文件后存在元数据同步延迟，导致系统尝试打开文件时，Dropbox侧还未完成文件路径的注册。

可行解决方案 #

1. 添加重试机制 #

针对同步延迟问题，在获取到null输出流时，短暂延迟后重试2-3次（间隔500ms左右），给Dropbox足够时间完成元数据同步：

int retryCount = 0;
OutputStream os = null;
while (os == null && retryCount < 3) {
    try {
        os = mContext.getContentResolver().openOutputStream(fileUri);
        if (os == null) {
            Thread.sleep(500);
            retryCount++;
        }
    } catch (IOException | InterruptedException e) {
        e.printStackTrace();
        break;
    }
}

if (os != null) {
    try (os) {
        // 执行数据写入逻辑
    } catch (IOException e) {
        e.printStackTrace();
    }
} else {
    // 重试失败后的错误处理
}

2. 使用Dropbox官方SDK替代Documents Provider #

直接集成Dropbox Android SDK处理文件上传，绕过系统Documents Provider的兼容性问题：

• 添加依赖：

implementation 'com.dropbox.core:dropbox-core-sdk:5.4.0'

• 初始化客户端并上传文件（需先完成OAuth授权获取accessToken）：

DbxRequestConfig config = DbxRequestConfig.newBuilder("YourAppName").build();
DbxClientV2 client = new DbxClientV2(config, "your_access_token");

try (InputStream in = new FileInputStream(localFile)) {
    FileMetadata metadata = client.files().uploadBuilder("/Dropbox/Target/Path/filename.ext")
            .uploadAndFinish(in);
} catch (DbxException | IOException e) {
    e.printStackTrace();
}

3. 检查并规范文件名 #

确保创建文件时的文件名符合Dropbox命名规则，避免使用/ \ : * ? " < > |这类特殊字符，部分特殊字符可能导致Dropbox无法正确生成文件路径。

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