Android 11+自定义目录存储Bitmap图片失败问题求助

问题分析 #

你已申请MANAGE_EXTERNAL_STORAGE权限，能正常创建目录但无法写入Bitmap，核心问题可能出在以下几个方面：

1. 目录创建逻辑不严谨 #

使用mkdir()仅能创建单级目录，若父目录存在异常（如权限临时失效）会导致创建失败；且未检查目录创建的返回值，无法及时发现问题。

2. 权限申请无回调处理 #

你直接启动权限设置页面，但未处理用户授权后的返回逻辑——用户授予权限返回后，原存储代码可能已经执行完毕，导致写入逻辑在权限未真正生效时运行。

3. 文件名包含特殊字符 #

子目录名使用dd-MM-yyyy HH:mm:ss格式，其中的冒号:虽符合Linux文件系统规则，但部分系统组件或媒体扫描工具对特殊字符处理异常，可能导致文件写入后无法被识别。

4. Bitmap有效性未验证 #

若循环中的Bitmap为空或已被回收，compress()方法会静默失败，不会抛出异常，最终生成空文件或无文件。

5. 异常信息未充分暴露 #

仅打印栈轨迹未展示具体错误内容，无法快速定位是IO异常、Bitmap异常还是路径问题。

解决方案 #

步骤1：修复目录创建逻辑 #

替换mkdir()为mkdirs()（确保多级目录都能创建），并检查返回值确认创建成功：

File mainDir = new File(Environment.getExternalStorageDirectory(), "LaundryImages");
if (!mainDir.exists()) {
    boolean isMainDirCreated = mainDir.mkdirs();
    if (!isMainDirCreated) {
        tv.setText("主目录LaundryImages创建失败");
        return;
    }
}

String subDirName = new SimpleDateFormat("dd-MM-yyyy HH-mm-ss", Locale.getDefault()).format(new Date());
File subDir = new File(mainDir, subDirName);
if (!subDir.exists()) {
    boolean isSubDirCreated = subDir.mkdirs();
    if (!isSubDirCreated) {
        tv.setText("子目录" + subDirName + "创建失败");
        return;
    }
}

步骤2：处理权限申请回调 #

用ActivityResultContracts实现权限申请的回调，确保权限真正授予后再执行存储逻辑：

// Activity中初始化权限请求器
private ActivityResultLauncher<Intent> storagePermissionLauncher;

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);
    tv = findViewById(R.id.textView);

    storagePermissionLauncher = registerForActivityResult(
        new ActivityResultContracts.StartActivityForResult(),
        result -> {
            if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.R) {
                if (Environment.isExternalStorageManager()) {
                    saveBitmapsToDirectory(l); // l为你的Bitmap列表
                } else {
                    tv.setText("未获取存储权限，无法保存图片");
                }
            }
        }
    );

    checkStoragePermission();
}

private void checkStoragePermission() {
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.R) {
        if (!Environment.isExternalStorageManager()) {
            Uri uri = Uri.parse("package:" + BuildConfig.APPLICATION_ID);
            Intent intent = new Intent(Settings.ACTION_MANAGE_APP_ALL_FILES_ACCESS_PERMISSION, uri);
            storagePermissionLauncher.launch(intent);
        } else {
            saveBitmapsToDirectory(l);
        }
    }
}

步骤3：验证Bitmap有效性 #

在循环中添加Bitmap非空及未回收的检查：

int count = 0;
for (Bitmap bm : l) {
    count++;
    if (bm == null || bm.isRecycled()) {
        tv.setText("第" + count + "张Bitmap无效，跳过");
        continue;
    }
    // 后续文件写入逻辑
}

步骤4：完善异常处理 #

捕获具体异常类型并展示错误信息：

try (FileOutputStream out = new FileOutputStream(imageFile)) {
    boolean isCompressed = bm.compress(Bitmap.CompressFormat.JPEG, 100, out);
    if (isCompressed) {
        tv.setText("第" + count + "张图片保存成功");
    } else {
        tv.setText("第" + count + "张图片压缩失败");
    }
} catch (FileNotFoundException e) {
    tv.setText("第" + count + "张图片：文件未找到 - " + e.getMessage());
    e.printStackTrace();
} catch (IOException e) {
    tv.setText("第" + count + "张图片：IO错误 - " + e.getMessage());
    e.printStackTrace();
}

可选：改用Scoped Storage（推荐） #

MANAGE_EXTERNAL_STORAGE属于特殊权限，Google Play审核可能拒绝应用。若无需访问其他应用文件，推荐用MediaStore API存入自定义目录：

private void saveBitmapWithMediaStore(Bitmap bitmap, String displayName) {
    ContentValues values = new ContentValues();
    values.put(MediaStore.Images.Media.DISPLAY_NAME, displayName);
    values.put(MediaStore.Images.Media.MIME_TYPE, "image/jpeg");
    values.put(MediaStore.Images.Media.RELATIVE_PATH, "Pictures/LaundryImages/" + new SimpleDateFormat("dd-MM-yyyy HH-mm-ss", Locale.getDefault()).format(new Date()));

    Uri uri = getContentResolver().insert(MediaStore.Images.Media.EXTERNAL_CONTENT_URI, values);
    if (uri != null) {
        try (OutputStream outputStream = getContentResolver().openOutputStream(uri)) {
            bitmap.compress(Bitmap.CompressFormat.JPEG, 100, outputStream);
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}

修改后的完整代码示例 #

public class MainActivity extends AppCompatActivity {

    private TextView tv;
    private ActivityResultLauncher<Intent> storagePermissionLauncher;
    private List<Bitmap> l; // 你的Bitmap列表

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        tv = findViewById(R.id.textView);

        // 初始化Bitmap列表（根据实际场景替换）
        l = new ArrayList<>();

        // 初始化权限请求器
        storagePermissionLauncher = registerForActivityResult(
                new ActivityResultContracts.StartActivityForResult(),
                result -> {
                    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.R) {
                        if (Environment.isExternalStorageManager()) {
                            saveBitmapsToDirectory(l);
                        } else {
                            tv.setText("未获取存储权限，无法保存图片");
                        }
                    }
                }
        );

        checkStoragePermission();
    }

    private void checkStoragePermission() {
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.R) {
            if (!Environment.isExternalStorageManager()) {
                Uri uri = Uri.parse("package:" + BuildConfig.APPLICATION_ID);
                Intent intent = new Intent(Settings.ACTION_MANAGE_APP_ALL_FILES_ACCESS_PERMISSION, uri);
                storagePermissionLauncher.launch(intent);
            } else {
                saveBitmapsToDirectory(l);
            }
        } else {
            // 兼容Android 10及以下的WRITE_EXTERNAL_STORAGE权限
            if (ContextCompat.checkSelfPermission(this, Manifest.permission.WRITE_EXTERNAL_STORAGE) != PackageManager.PERMISSION_GRANTED) {
                ActivityCompat.requestPermissions(this, new String[]{Manifest.permission.WRITE_EXTERNAL_STORAGE}, 100);
            } else {
                saveBitmapsToDirectory(l);
            }
        }
    }

    private void saveBitmapsToDirectory(List<Bitmap> bitmapList) {
        File mainDir = new File(Environment.getExternalStorageDirectory(), "LaundryImages");
        if (!mainDir.exists()) {
            boolean isMainDirCreated = mainDir.mkdirs();
            if (!isMainDirCreated) {
                tv.setText("主目录LaundryImages创建失败");
                return;
            }
        }

        String subDirName = new SimpleDateFormat("dd-MM-yyyy HH-mm-ss", Locale.getDefault()).format(new Date());
        File subDir = new File(mainDir, subDirName);
        if (!subDir.exists()) {
            boolean isSubDirCreated = subDir.mkdirs();
            if (!isSubDirCreated) {
                tv.setText("子目录" + subDirName + "创建失败");
                return;
            }
        }

        int count = 0;
        for (Bitmap bm : bitmapList) {
            count++;
            if (bm == null || bm.isRecycled()) {
                tv.setText("第" + count + "张Bitmap无效，跳过");
                continue;
            }

            File imageFile = new File(subDir, count + ".jpg");
            try (FileOutputStream out = new FileOutputStream(imageFile)) {
                boolean isCompressed = bm.compress(Bitmap.CompressFormat.JPEG, 100, out);
                if (isCompressed) {
                    tv.setText("第" + count + "张图片保存成功");
                } else {
                    tv.setText("第" + count + "张图片压缩失败");
                }
            } catch (FileNotFoundException e) {
                tv.setText("第" + count + "张图片：文件未找到 - " + e.getMessage());
                e.printStackTrace();
            } catch (IOException e) {
                tv.setText("第" + count + "张图片：IO错误 - " + e.getMessage());
                e.printStackTrace();
            }
        }

        tv.setText("所有图片处理完成");
    }

    @Override
    public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {
        super.onRequestPermissionsResult(requestCode, permissions, grantResults);
        if (requestCode == 100) {
            if (grantResults.length > 0 && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
                saveBitmapsToDirectory(l);
            } else {
                tv.setText("未获取存储权限");
            }
        }
    }
}

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