保存Bitmap图片时持续出现权限拒绝或文件不存在错误，求解决方案

我之前在做Bitmap存储的时候也踩过完全一样的坑！明明Manifest里加了权限，换了N个路径还是报错，折腾了好一阵子才理清所有坑点，给你梳理几个最可能的原因和解决办法：

1. 别忘了动态申请危险权限（Android 6.0+） #

Manifest里的权限声明只是静态声明，Android 6.0（API 23）及以上的危险权限（比如WRITE_EXTERNAL_STORAGE）必须在代码里主动请求用户授权，否则就算Manifest加了也没用。

举个动态申请权限的例子：

// 检查权限
if (ContextCompat.checkSelfPermission(this, Manifest.permission.WRITE_EXTERNAL_STORAGE) != PackageManager.PERMISSION_GRANTED) {
    // 申请权限
    ActivityCompat.requestPermissions(this, new String[]{Manifest.permission.WRITE_EXTERNAL_STORAGE}, 1001);
} else {
    // 权限已授权，执行保存Bitmap操作
    saveBitmapToFile(bitmap);
}

// 处理权限申请结果
@Override
public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {
    super.onRequestPermissionsResult(requestCode, permissions, grantResults);
    if (requestCode == 1001) {
        if (grantResults.length > 0 && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
            // 用户授权成功，执行保存
            saveBitmapToFile(bitmap);
        } else {
            // 用户拒绝授权，提示用户开启权限
            Toast.makeText(this, "需要存储权限才能保存图片", Toast.LENGTH_SHORT).show();
        }
    }
}

2. Android 10+的分区存储限制（最容易踩的坑） #

从Android 10（API 29）开始，系统默认启用分区存储，就算你有WRITE_EXTERNAL_STORAGE权限，也不能直接写入外部存储的自定义文件夹（比如/sdcard/MyImages），这时候会直接报Permission Denied。

解决办法分两种情况：

• 如果你只是兼容到Android 10，可以在Manifest的<application>标签里加一行：

  android:requestLegacyExternalStorage="true"
  

  这样可以暂时关闭分区存储限制，继续用旧的文件路径写法。
• 如果你要适配Android 11+，推荐用MediaStore来保存图片，或者用应用专属目录：
  • 应用专属目录：不需要任何权限，其他应用无法访问，适合只在自己应用里用的图片。比如：

    // 获取应用专属的外部存储目录
    File saveDir = getExternalFilesDir(Environment.DIRECTORY_PICTURES);
    if (!saveDir.exists()) {
        saveDir.mkdirs(); // 确保目录存在
    }
    File file = new File(saveDir, "my_bitmap.png");
    // 然后写入Bitmap到这个file里
    

3. 路径必须先创建目录，否则会报"No such file or directory" #

不管你用什么路径，一定要先检查目标文件夹是否存在，如果不存在必须调用mkdirs()创建（注意是mkdirs，不是mkdir，mkdir只能创建一级目录，mkdirs可以创建多级目录）。

比如：

File saveDir = new File(Environment.getExternalStorageDirectory(), "MyAppImages");
if (!saveDir.exists()) {
    // 递归创建所有父目录
    boolean isCreated = saveDir.mkdirs();
    if (!isCreated) {
        // 创建目录失败，这里要做错误处理
        Toast.makeText(this, "创建存储目录失败", Toast.LENGTH_SHORT).show();
        return;
    }
}
File bitmapFile = new File(saveDir, "test.png");
// 接下来写入Bitmap

4. 避免使用硬编码的绝对路径 #

不要直接写/sdcard/xxx这种硬编码路径，因为不同设备的外部存储路径可能不一样，应该用系统提供的API获取路径：

• 外部公共目录：Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_PICTURES)
• 应用专属外部目录：getExternalFilesDir(null)或者指定目录getExternalFilesDir(Environment.DIRECTORY_PICTURES)

最后再给你一个完整的Bitmap保存示例（适配Android 10+，用应用专属目录）：

private void saveBitmapToFile(Bitmap bitmap) {
    File saveDir = getExternalFilesDir(Environment.DIRECTORY_PICTURES);
    if (saveDir == null) {
        Toast.makeText(this, "无法获取存储目录", Toast.LENGTH_SHORT).show();
        return;
    }
    if (!saveDir.exists()) {
        saveDir.mkdirs();
    }
    File file = new File(saveDir, System.currentTimeMillis() + ".png");
    try (FileOutputStream fos = new FileOutputStream(file)) {
        bitmap.compress(Bitmap.CompressFormat.PNG, 100, fos);
        fos.flush();
        Toast.makeText(this, "图片保存成功：" + file.getAbsolutePath(), Toast.LENGTH_SHORT).show();
    } catch (IOException e) {
        e.printStackTrace();
        Toast.makeText(this, "保存失败：" + e.getMessage(), Toast.LENGTH_SHORT).show();
    }
}

你可以按照这个顺序排查：先确认动态权限是否申请了，然后看Android版本是否触发了分区存储，再检查路径是否创建成功，应该就能解决问题了！

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