Android Nougat系统中Bitmap无法保存至应用目录求助

嘿，这个问题我之前帮不少开发者踩过坑，Android 7.0（Nougat，API24）开始的存储规则变化确实容易导致旧代码失效，我来给你拆解下原因和修复方案：

问题根源 #

你的代码在Nougat以下正常，但高版本出问题，主要是两个关键点：

• 动态权限要求：从Android 6.0（API23）开始，WRITE_EXTERNAL_STORAGE属于危险权限，必须在运行时动态申请，而不仅仅是在Manifest里声明。Nougat进一步严格了这个规则，没申请权限直接写存储会抛出异常。
• 公共目录写入限制：部分Nougat+设备的系统会限制直接写入外部存储根目录，这种情况下即使有权限也可能写失败。

修复方案 #

方案1：适配动态权限（适合保存到公共目录） #

如果你必须把图片存到外部存储根目录下的自定义文件夹，那得先搞定权限申请：

1. 先在AndroidManifest.xml里声明权限：

<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<!-- 针对Android 10+，还需要额外声明这个（maxSdkVersion限制避免影响更高版本） -->
<uses-permission android:name="android.permission.MANAGE_EXTERNAL_STORAGE" android:maxSdkVersion="30" />

2. 在代码里动态申请权限，之后再执行保存逻辑：

// 检查是否已获取存储权限
if (ContextCompat.checkSelfPermission(this, Manifest.permission.WRITE_EXTERNAL_STORAGE) != PackageManager.PERMISSION_GRANTED) {
    // 弹出权限申请对话框
    ActivityCompat.requestPermissions(this, new String[]{Manifest.permission.WRITE_EXTERNAL_STORAGE}, 1001);
} else {
    // 权限已就绪，执行保存
    saveBitmap(finalBitmap, folderNAme, picName, format, quality);
}

// 处理权限申请结果
@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) {
            saveBitmap(finalBitmap, folderNAme, picName, format, quality);
        } else {
            Toast.makeText(this, "需要存储权限才能保存图片哦", Toast.LENGTH_SHORT).show();
        }
    }
}

// 把你的保存逻辑封装成方法
private void saveBitmap(Bitmap finalBitmap, String folderNAme, String picName, String format, int quality) {
    String getRoot = Environment.getExternalStorageDirectory().getAbsolutePath();
    File myDir = new File(getRoot + "/" + folderNAme);
    String fname = picName + format;
    File file = new File(myDir, fname);
    
    try {
        // 先确保文件夹存在
        if (!myDir.exists()) {
            myDir.mkdirs();
        }
        FileOutputStream out = new FileOutputStream(file);
        finalBitmap.compress(Bitmap.CompressFormat.valueOf(format.toUpperCase()), quality, out);
        out.flush();
        out.close();
        // 通知媒体库扫描，让图片在相册显示
        MediaScannerConnection.scanFile(this, new String[]{file.getAbsolutePath()}, null, null);
    } catch (IOException e) {
        e.printStackTrace();
        Toast.makeText(this, "图片保存失败", Toast.LENGTH_SHORT).show();
    }
}

方案2：使用应用专属外部目录（更推荐） #

如果不需要把图片放到公共目录，强烈推荐用应用专属的外部存储目录——从Android 4.4开始，这个目录不需要申请存储权限，而且不会被系统清理，在高版本系统里更稳定：

修改你的路径逻辑就行：

private void saveBitmap(Bitmap finalBitmap, String folderNAme, String picName, String format, int quality) {
    // 路径示例：/sdcard/Android/data/你的应用包名/files/自定义文件夹
    File myDir = new File(getExternalFilesDir(null), folderNAme);
    String fname = picName + format;
    File file = new File(myDir, fname);
    
    try {
        if (!myDir.exists()) {
            myDir.mkdirs();
        }
        FileOutputStream out = new FileOutputStream(file);
        finalBitmap.compress(Bitmap.CompressFormat.valueOf(format.toUpperCase()), quality, out);
        out.flush();
        out.close();
        // 同样通知媒体库扫描
        MediaScannerConnection.scanFile(this, new String[]{file.getAbsolutePath()}, null, null);
        Toast.makeText(this, "图片保存成功", Toast.LENGTH_SHORT).show();
    } catch (IOException e) {
        e.printStackTrace();
        Toast.makeText(this, "图片保存失败", Toast.LENGTH_SHORT).show();
    }
}

额外小贴士 #

• 保存完成后调用MediaScannerConnection.scanFile()很重要，不然你保存的图片可能只能在文件管理器找到，不会出现在系统相册里。
• 如果是Android 11+（API30）及以上，用方案2的专属目录完全不用处理复杂的存储权限，省心很多。

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