Android保存Bitmap为JPEG时遭遇ENOENT文件不存在错误求助

核心错误原因 #

1. 路径硬编码错误：你手动拼接的/Users/johnathan/Downloads是电脑系统路径，Android设备的公共Downloads目录位于外部存储根目录下的Downloads文件夹，而非自定义的Users/johnathan/Downloads。
2. 未适配Scoped Storage：Android 10（API 29）及以上版本启用了Scoped Storage，禁止直接访问外部存储的自定义目录，必须通过MediaStore或存储访问框架（SAF）操作公共目录。
3. 未检查目录创建结果：原代码中myDir.mkdirs()可能因权限或系统限制创建失败，但未做判断，导致后续写入文件时触发"文件不存在"错误。
4. 权限缺失：Android 9及以下版本需要WRITE_EXTERNAL_STORAGE权限，且需动态申请。

解决方案 #

方案1：适配Android 10+（推荐，符合Scoped Storage规范）

使用MediaStore将图片保存到系统公共Downloads目录，无需申请存储权限：

private void saveImageToDownloads(Bitmap finalBitmap) {
    ContentValues values = new ContentValues();
    // 设置文件名
    String fileName = "Image-" + new Random().nextInt(10000) + ".jpeg";
    values.put(MediaStore.Images.Media.DISPLAY_NAME, fileName);
    // 设置文件类型
    values.put(MediaStore.Images.Media.MIME_TYPE, "image/jpeg");
    // 指定保存到Downloads目录
    values.put(MediaStore.Images.Media.RELATIVE_PATH, Environment.DIRECTORY_DOWNLOADS);

    ContentResolver resolver = getContentResolver();
    Uri imageUri = resolver.insert(MediaStore.Images.Media.EXTERNAL_CONTENT_URI, values);

    if (imageUri != null) {
        try (OutputStream outputStream = resolver.openOutputStream(imageUri)) {
            // 压缩并写入图片
            boolean compressSuccess = finalBitmap.compress(Bitmap.CompressFormat.JPEG, 90, outputStream);
            if (compressSuccess) {
                // 通知系统图库更新
                sendBroadcast(new Intent(Intent.ACTION_MEDIA_SCANNER_SCAN_FILE, imageUri));
            } else {
                // 压缩失败，删除空文件
                resolver.delete(imageUri, null, null);
            }
        } catch (IOException e) {
            e.printStackTrace();
            // 写入失败，删除空文件
            resolver.delete(imageUri, null, null);
        }
    }
}

方案2：兼容Android 9及以下版本

1. 添加权限声明：在AndroidManifest.xml中添加权限（仅针对旧版本）：

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

2. 动态申请权限：在调用保存方法前检查并申请权限：

private static final int REQUEST_WRITE_PERM = 100;

// 调用保存方法前检查权限
private void checkPermissionThenSave(Bitmap bitmap) {
    if (Build.VERSION.SDK_INT <= Build.VERSION_CODES.P) {
        if (ContextCompat.checkSelfPermission(this, Manifest.permission.WRITE_EXTERNAL_STORAGE)
                != PackageManager.PERMISSION_GRANTED) {
            ActivityCompat.requestPermissions(this,
                    new String[]{Manifest.permission.WRITE_EXTERNAL_STORAGE},
                    REQUEST_WRITE_PERM);
            return;
        }
    }
    saveImageLegacy(bitmap);
}

// 处理权限申请结果
@Override
public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {
    super.onRequestPermissionsResult(requestCode, permissions, grantResults);
    if (requestCode == REQUEST_WRITE_PERM) {
        if (grantResults.length > 0 && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
            // 权限通过，执行保存（需持有要保存的Bitmap对象）
            // saveImageLegacy(yourBitmap);
        } else {
            Toast.makeText(this, "需要存储权限才能保存图片", Toast.LENGTH_SHORT).show();
        }
    }
}

3. 旧版本保存方法：

private void saveImageLegacy(Bitmap finalBitmap) {
    // 获取系统公共Downloads目录
    File downloadsDir = Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_DOWNLOADS);
    // 检查目录是否存在，不存在则创建并判断是否成功
    if (!downloadsDir.exists()) {
        if (!downloadsDir.mkdirs()) {
            Log.e("SaveImage", "创建Downloads目录失败");
            return;
        }
    }

    String fileName = "Image-" + new Random().nextInt(10000) + ".jpeg";
    File imageFile = new File(downloadsDir, fileName);

    try (FileOutputStream out = new FileOutputStream(imageFile)) {
        finalBitmap.compress(Bitmap.CompressFormat.JPEG, 90, out);
        // 通知图库更新
        sendBroadcast(new Intent(Intent.ACTION_MEDIA_SCANNER_SCAN_FILE, Uri.fromFile(imageFile)));
    } catch (IOException e) {
        e.printStackTrace();
    }
}

额外注意事项 #

• 避免手动拼接路径：始终使用Android提供的Environment或Context相关API获取存储目录，确保路径兼容性。
• 关闭流资源：使用try-with-resources语法自动关闭流，避免资源泄漏。
• 通知系统更新：保存图片后发送广播，让图库等应用能立即识别到新图片。

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