安卓开发调用mkdirs无法在内部存储创建目录问题求助

问题对应的解决方案 #

• API 23+ 动态申请存储权限
  manifest中声明权限仅为配置前提，Android 6.0及以上版本中WRITE_EXTERNAL_STORAGE属于危险权限，必须在代码中主动触发动态申请，待用户手动同意后才能获得写入权限。示例代码：

// 权限申请请求码可自定义
private static final int REQUEST_STORAGE_PERM = 1001;

if (ContextCompat.checkSelfPermission(this, Manifest.permission.WRITE_EXTERNAL_STORAGE) != PackageManager.PERMISSION_GRANTED) {
    ActivityCompat.requestPermissions(this, new String[]{Manifest.permission.WRITE_EXTERNAL_STORAGE}, REQUEST_STORAGE_PERM);
}
// 后续在onRequestPermissionsResult回调中判断权限是否授予

• API 30+ 单独处理所有文件访问权限
  Android 11及以上版本中，MANAGE_EXTERNAL_STORAGE权限无法通过普通动态申请获取，必须跳转系统设置页引导用户手动开启「所有文件访问权限」，才能写入公共存储根目录：

if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.R) {
    if (!Environment.isExternalStorageManager()) {
        Intent intent = new Intent(Settings.ACTION_MANAGE_ALL_FILES_ACCESS_PERMISSION);
        startActivity(intent);
        // 后续返回时判断Environment.isExternalStorageManager()确认权限开启状态
    }
}

• 添加操作结果校验
  mkdirs()方法会返回boolean类型的操作结果，建议增加判断逻辑定位问题：

File file = new File(path,"TestFolder");
if (!file.exists()) {
    boolean createSuccess = file.mkdirs();
    Log.e("createResult", "创建结果：" + createSuccess);
} else {
    Log.e("createResult", "文件夹已存在");
}

同时提前校验path变量取值是否正确，需确保其取值为Environment.getExternalStorageDirectory().getAbsolutePath()，避免路径本身错误。

• 优先使用应用专属目录（无需权限）
  如果不需要用户在系统文件管理器中直接访问该文件夹，建议优先使用应用专属外部存储目录，该路径下读写不需要申请任何存储权限，适配所有Android版本：

// 路径为 /storage/emulated/0/Android/data/[你的包名]/files/TestFolder
File file = new File(getExternalFilesDir(null), "TestFolder");
file.mkdirs();

内容的提问来源于stack exchange，提问作者Mr.Goomer