Android设备图片保存至外部存储（SD卡）报错及解决咨询

错误原因分析 #

你遇到的NullPointerException是因为创建FileOutputStream失败时（比如目标目录不存在、无存储权限），fos会保持null状态，而finally块中直接调用fos.close()，触发空指针异常。

分步解决方案 #

1. 确保目标目录存在 #

在创建文件前，先检查并递归创建目标目录，否则无法写入文件：

File rootDir = new File(Environment.getExternalStorageDirectory().getAbsolutePath() + "/imagesDir");
if (!rootDir.exists()) {
    rootDir.mkdirs();
}

2. 避免空指针调用close() #

在finally块中先判断fos是否为null，再执行关闭操作：

finally {
    if (fos != null) {
        try {
            fos.close();
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}

3. 处理存储权限 #

• Android 6.0（API 23）及以上：需动态申请WRITE_EXTERNAL_STORAGE权限，调用保存方法前先检查权限，未授权则发起申请。
• Android 10（API 29）及以上：直接使用Environment.getExternalStorageDirectory()会受存储限制，推荐两种方案：
  • 用应用专属外部存储（无需额外权限）：

    File rootDir = getExternalFilesDir(Environment.DIRECTORY_PICTURES);
    

  • 用MediaStore API写入公共目录（无需申请WRITE权限）。

修正后的完整代码 #

private String saveToExternalStorage(Bitmap bitmapImage, String nameImage, int compression) {
    // 可选：使用应用专属外部存储（Android 10+推荐）
    // File rootDir = getExternalFilesDir(Environment.DIRECTORY_PICTURES);
    // 若要保存到公共目录，使用下面路径并确保权限
    File rootDir = new File(Environment.getExternalStorageDirectory().getAbsolutePath() + "/imagesDir");
    
    // 确保目录存在，创建失败则返回null
    if (!rootDir.exists() && !rootDir.mkdirs()) {
        return null;
    }

    File file = new File(rootDir, nameImage);
    FileOutputStream fos = null;
    try {
        fos = new FileOutputStream(file);
        bitmapImage.compress(Bitmap.CompressFormat.JPEG, compression, fos);
        fos.flush(); // 确保数据完全写入
    } catch (Exception e) {
        e.printStackTrace();
        return null; // 保存失败返回null
    } finally {
        if (fos != null) {
            try {
                fos.close();
            } catch (IOException e) {
                e.printStackTrace();
            }
        }
    }
    return file.getAbsolutePath();
}

额外注意事项 #

• 若要保存到可移除SD卡（非内置外部存储），Environment.getExternalStorageDirectory()指向的是内置存储，需通过Context.getExternalFilesDirs()获取所有外部存储路径，判断并选择可移除SD卡的路径。
• Android 11（API 30）及以上访问公共目录需MANAGE_EXTERNAL_STORAGE权限，该权限需用户手动授权，且Google Play可能限制使用，优先推荐MediaStore方案。

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