Android应用向外部存储下载文件夹写文件时异常求助

我来帮你搞定这个头疼的问题！你已经申请了存储权限却还是在FileWriter fw = new FileWriter(destinationFile);这行报错，十有八九是因为Android 10（API 29）及以上的分区存储机制限制了直接用File API操作公共下载目录，或者你构造文件路径的方式不对。下面给你拆解问题和对应的解决办法：

核心原因：分区存储的限制 #

从Android 10开始，Google引入了分区存储（Scoped Storage），默认情况下，即使你拿到了WRITE_EXTERNAL_STORAGE权限，也不能直接通过File类读写公共目录（比如Download、Pictures这些）。而且如果你的App targetSdk是30（Android 11）及以上，之前用来兼容的android:requestLegacyExternalStorage="true"属性也会失效，所以不能再依赖这种临时方案了。

正确的解决办法分两种场景 #

场景1：推荐用MediaStore写入（兼容所有高版本） #

这是Google官方推荐的方式，不需要额外权限（Android 10+），直接通过ContentResolver操作MediaStore来写入下载目录：

// 要写入的文本内容
String textContent = "这是要保存到下载文件夹的文本";

// 构造ContentValues，设置文件信息
ContentValues contentValues = new ContentValues();
contentValues.put(MediaStore.Downloads.DISPLAY_NAME, "my_text_file.txt"); // 文件名
contentValues.put(MediaStore.Downloads.MIME_TYPE, "text/plain"); // 文件类型
// Android Q及以上需要指定相对路径为Download目录
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
    contentValues.put(MediaStore.Downloads.RELATIVE_PATH, Environment.DIRECTORY_DOWNLOADS);
}

// 获取ContentResolver并插入文件条目
ContentResolver resolver = getApplicationContext().getContentResolver();
Uri fileUri = resolver.insert(MediaStore.Downloads.EXTERNAL_CONTENT_URI, contentValues);

if (fileUri != null) {
    try (OutputStream outputStream = resolver.openOutputStream(fileUri)) {
        if (outputStream != null) {
            outputStream.write(textContent.getBytes(StandardCharsets.UTF_8));
            // 写入成功，这里可以加个Toast提示用户
        }
    } catch (IOException e) {
        e.printStackTrace();
        // 处理写入失败的情况
    }
}

场景2：一定要用File API（仅兼容Android 9及以下，或临时兼容） #

如果你只是临时兼容旧版本，或者必须用File API，那得确保：

1. 在Manifest里添加android:requestLegacyExternalStorage="true"（仅Android 10有效，Android 11+无效）
2. 正确构造下载目录的路径：

// 获取公共下载目录的正确路径
File downloadDirectory = Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_DOWNLOADS);
// 拼接文件名，创建目标文件
File destinationFile = new File(downloadDirectory, "my_text_file.txt");

// 尝试写入
try {
    // 确保父目录存在
    if (!downloadDirectory.exists()) {
        downloadDirectory.mkdirs();
    }
    FileWriter fw = new FileWriter(destinationFile);
    fw.write("你的文本内容");
    fw.flush();
    fw.close();
} catch (IOException e) {
    // 打印异常详情，方便排查
    e.printStackTrace();
    Log.e("FileWriteError", "写入失败：" + e.getMessage());
}

关键排查步骤 #

别忘了打印异常的具体信息！比如调用e.printStackTrace()或者Log.e("TAG", e.getMessage())，如果是：

• Permission denied：要么是权限没真正获取到（比如动态权限申请没通过），要么是分区存储限制；
• No such file or directory：大概率是你构造的文件路径错误，比如没正确获取Download目录。

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