Android Studio执行创建文件代码后未生成文件夹及文件，求排查

1. 权限配置与授权问题 #

• Android 10（API 29）及以下版本：需在AndroidManifest.xml中声明存储权限

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

  同时API 23及以上必须动态申请权限，仅靠清单配置无法获得用户授权，需在代码中调用requestPermissions()主动获取许可。
• Android 11（API 30）及以上版本：WRITE_EXTERNAL_STORAGE权限已废弃，默认无法直接写入公共外部存储根目录。若要兼容旧逻辑，需在AndroidManifest.xml的<application>标签内添加：

  android:requestLegacyExternalStorage="true"
  

  新应用建议直接采用Scoped Storage规范，避免依赖该兼容属性。

2. 存储路径兼容性问题 #

Environment.getExternalStorageDirectory()在Android 10+已被标记为废弃，且Scoped Storage模式下禁止直接写入根目录。可改用应用专属外部存储路径，无需额外权限：

String rootPath = getExternalFilesDir(null).getAbsolutePath() + "/MyFolder/";

该路径属于应用私有存储区，卸载应用时会自动清理，无需权限申请即可读写。

3. 代码逻辑的隐性错误 #

• 不要忽略mkdirs()和createNewFile()的返回值，添加日志排查创建失败原因：

  if (!root.exists()) {
      boolean dirCreated = root.mkdirs();
      if (!dirCreated) {
          Log.e("StorageError", "文件夹创建失败");
      }
  }
  boolean fileCreated = f.createNewFile();
  if (!fileCreated) {
      Log.e("StorageError", "文件创建失败");
  }
  

• 查看Logcat中e.printStackTrace()的输出信息，权限拒绝、路径只读、存储空间不足等异常都会在这里暴露。

4. 文件可见性延迟问题 #

• 即使文件创建成功，系统媒体库不会实时刷新，导致文件管理器无法立即看到。可调用以下代码通知系统扫描新文件：

  MediaScannerConnection.scanFile(this, new String[]{f.getAbsolutePath()}, null, null);
  

• Android 11+的文件管理器默认不展示应用专属外部存储内容，需手动进入Android/data/你的应用包名/files/路径查看。

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