Android向Pictures等公共目录写入位图时FileOutputStream不可写问题求助

问题核心原因 #

你调用的Environment.getRootDirectory()API获取的是Android系统分区的根路径，对应/system目录，这个分区默认是只读挂载的，哪怕授予了所有文件访问权限，普通应用也没有写入权限。你打印出来的/system/Pictures路径本身就不存在，也无法创建文件，自然会抛出找不到目录、不可写的错误。
你在文件管理器看到的「手机存储」对应的是公共共享存储目录，和系统分区是完全独立的存储区域，需要调用对应API才能访问。

正确实现方案 #

1. Android 10（API 29）及以上版本（推荐方案） #

Android 10开始引入分区存储机制，官方推荐使用MediaStoreAPI写入公共媒体目录，不需要申请特殊存储权限，示例代码：

ContentValues values = new ContentValues();
values.put(MediaStore.Images.Media.DISPLAY_NAME, "pic.png");
values.put(MediaStore.Images.Media.MIME_TYPE, "image/png");
values.put(MediaStore.Images.Media.RELATIVE_PATH, Environment.DIRECTORY_PICTURES);

ContentResolver resolver = getContentResolver();
Uri imageUri = resolver.insert(MediaStore.Images.Media.EXTERNAL_CONTENT_URI, values);
if (imageUri != null) {
    OutputStream outputStream = resolver.openOutputStream(imageUri);
    // 将你的位图压缩写入输出流
    yourBitmap.compress(Bitmap.CompressFormat.PNG, 100, outputStream);
    outputStream.close();
}

2. Android 9（API 28）及以下版本 #

如果需要兼容旧版本系统使用File API操作，需要调用Environment.getExternalStoragePublicDirectory()获取公共目录，同时要先判断目录是否存在，不存在则主动创建：

// 注意：该API在Android 10及以上版本已废弃，仅可用于旧版本系统适配
File picDir = Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_PICTURES);
// 目录不存在则先创建
if (!picDir.exists()) {
    picDir.mkdirs();
}
File picFile = new File(picDir, "pic.png");
FileOutputStream out = new FileOutputStream(picFile);

额外配置要求 #

• 在AndroidManifest.xml中添加对应权限声明：

  <!-- Android 13及以上版本读取公共图片的权限，按需添加 -->
  <uses-permission android:name="android.permission.READ_MEDIA_IMAGES" />
  <!-- Android 12及以下版本的存储权限 -->
  <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" android:maxSdkVersion="32" />
  <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" android:maxSdkVersion="32" />
  

• 如果你targetSdkVersion >= 29且需要临时兼容旧的File API逻辑，可以在清单文件的application节点添加android:requestLegacyExternalStorage="true"开启legacy存储适配，该属性仅在Android 10/11有效，Android 12及以上版本已失效，长期适配建议切换为MediaStore方案。

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