Android 11已申请MANAGE_EXTERNAL_STORAGE仍存文件失败求助

以下是导致你遇到“OS Error: Operation not permitted, errno = 1”错误的核心原因及解决办法：

1. MANAGE_EXTERNAL_STORAGE权限的申请方式错误 #

Android 11开始，MANAGE_EXTERNAL_STORAGE属于特殊权限，无法通过常规的requestPermissions()方法请求授权，必须引导用户到系统设置页面手动开启：

• 先判断权限是否已授予：

  if (!Environment.isExternalStorageManager()) {
      // 跳转到应用权限设置页
      val intent = Intent(Settings.ACTION_MANAGE_APP_ALL_FILES_ACCESS_PERMISSION)
      intent.data = Uri.parse("package:" + applicationContext.packageName)
      startActivity(intent)
  }
  

• 不要用Context.checkSelfPermission(MANAGE_EXTERNAL_STORAGE)判断权限，这个方法对特殊权限返回的结果不准确，必须用Environment.isExternalStorageManager()。

2. Manifest权限声明需补充忽略警告 #

在Manifest中声明MANAGE_EXTERNAL_STORAGE时，需要添加tools:ignore="ScopedStorage"，否则会触发Scoped Storage相关的编译警告，且可能影响权限生效：

<uses-permission android:name="android.permission.MANAGE_EXTERNAL_STORAGE" tools:ignore="ScopedStorage" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" android:maxSdkVersion="29" />
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" android:maxSdkVersion="32" />

注意：WRITE_EXTERNAL_STORAGE在API 30+已失效，建议加上maxSdkVersion="29"。

3. 文件路径建议使用系统API获取 #

避免硬编码/storage/emulated/0/Documents，改用系统提供的API获取标准路径，兼容性更好：

val documentsDir = Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_DOCUMENTS)
val targetFile = File(documentsDir, "your_file_name.pdf")

如果需要创建子目录，要先调用mkdirs()确保目录存在：

val subDir = File(documentsDir, "AppExport")
if (!subDir.exists()) {
    subDir.mkdirs()
}

4. 确认权限授予状态再执行写入操作 #

在调用export方法前，必须再次检查Environment.isExternalStorageManager()返回true，再执行文件写入逻辑，避免用户未开启权限就执行操作。

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