Android将内部存储文件复制到外部存储下载文件夹遇权限问题求助

核心问题 #

你遇到的EPERM (Operation not permitted)错误，由两个关键原因导致：

1. 路径拼接错误：直接拼接字符串让目标路径变成了/storage/emulated/0/Downloadtest（缺少目录与文件名之间的斜杠），系统无法识别该非法路径。
2. Android存储权限限制：尤其是Android 10（API 29）及以上的Scoped Storage机制，直接通过File类写入公共下载目录会被系统限制。

分步解决 #

1. 修复路径拼接问题 #

不要直接用字符串拼接路径，改用File类的构造方法自动处理目录分隔符：

// 获取公共下载目录
File downloadDir = Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_DOWNLOADS);
// 创建目标文件对象（自动添加目录与文件名之间的斜杠）
File out = new File(downloadDir, "test");

2. 适配Android存储权限 #

根据应用适配的Android版本，选择对应方案：

方案一：Android 10+ 推荐使用MediaStore（符合Scoped Storage规范）

直接通过MediaStore写入公共下载目录，无需申请WRITE_EXTERNAL_STORAGE权限：

private void copyFileToDownloads(Context context, String fromPath, String fileName) {
    InputStream inStream = null;
    OutputStream outStream = null;
    try {
        File oldFile = new File(fromPath);
        if (!oldFile.exists()) return;

        // 配置MediaStore写入参数
        ContentValues values = new ContentValues();
        values.put(MediaStore.Downloads.DISPLAY_NAME, fileName);
        values.put(MediaStore.Downloads.MIME_TYPE, getFileMimeType(oldFile));
        values.put(MediaStore.Downloads.RELATIVE_PATH, Environment.DIRECTORY_DOWNLOADS);

        // 获取ContentResolver并插入文件记录
        ContentResolver resolver = context.getContentResolver();
        Uri uri = resolver.insert(MediaStore.Downloads.EXTERNAL_CONTENT_URI, values);
        if (uri == null) return;

        // 打开流并复制文件
        outStream = resolver.openOutputStream(uri);
        inStream = new FileInputStream(oldFile);

        byte[] buffer = new byte[4096];
        int bytesRead;
        while ((bytesRead = inStream.read(buffer)) != -1) {
            outStream.write(buffer, 0, bytesRead);
        }
    } catch (IOException e) {
        e.printStackTrace();
    } finally {
        try {
            if (inStream != null) inStream.close();
            if (outStream != null) outStream.close();
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}

// 辅助方法：获取文件MIME类型
private String getFileMimeType(File file) {
    String mimeType = null;
    String extension = MimeTypeMap.getFileExtensionFromUrl(file.getAbsolutePath());
    if (extension != null) {
        mimeType = MimeTypeMap.getSingleton().getMimeTypeFromExtension(extension);
    }
    return mimeType != null ? mimeType : "application/octet-stream";
}

方案二：适配Android 9及以下（或使用全存储权限）

如果需要兼容Android 9（API 28）及以下版本：

• 在AndroidManifest.xml中声明权限：

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

• 在代码中动态申请权限（Android 6.0+）：

// 检查并申请存储权限
if (ContextCompat.checkSelfPermission(this, Manifest.permission.WRITE_EXTERNAL_STORAGE)
        != PackageManager.PERMISSION_GRANTED) {
    ActivityCompat.requestPermissions(this,
            new String[]{Manifest.permission.WRITE_EXTERNAL_STORAGE},
            1001); // 自定义请求码
} else {
    // 权限已授予，执行原复制逻辑
    copyFile(attachmentFile.getAbsolutePath(), out.getAbsolutePath());
}

验证修正 #

修复路径后，目标路径会变为合法的/storage/emulated/0/Download/test，配合对应版本的权限适配，就能正常将文件写入下载目录。

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