Kotlin Android应用外部存储文件创建错误排查求助

我来帮你一步步揪出这个文件创建失败的问题，结合Android不同版本的存储规则，主要从这几个方向入手：

1. 权限配置有没有踩坑？ #

Android对外部存储的权限要求分版本，可别搞混了：

• Android 9及以下：必须在AndroidManifest.xml里加上读写权限，而且因为是危险权限，不能只靠清单声明，得在代码里动态申请：

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

• Android 10（API 29）及以上：系统默认开启了分区存储，直接用Environment.getExternalStoragePublicDirectory()会受限。要是还想继续用这个路径，得在AndroidManifest.xml的application标签里加个兼容属性：

  android:requestLegacyExternalStorage="true"
  

  不过这只是临时兼容方案，Android 11之后Google对这个属性的支持越来越严，长期来看建议用Scoped Storage。

• Android 11+：如果非要硬用公共目录，除了上面的兼容属性，还得申请MANAGE_EXTERNAL_STORAGE权限，但这个权限得用户手动去设置里开，而且Google审核的时候卡得很严，非必要别碰。

2. 动态权限申请是不是没执行？ #

就算清单里加了权限，Android 6.0+（API 23）及以上必须在代码里主动申请权限，不然系统会直接拒绝。给你一段现成的代码参考：

private val REQUEST_STORAGE_PERMISSION = 1001

// 检查并申请存储权限
fun checkStoragePermission() {
    if (ContextCompat.checkSelfPermission(this, Manifest.permission.WRITE_EXTERNAL_STORAGE)
        != PackageManager.PERMISSION_GRANTED
    ) {
        ActivityCompat.requestPermissions(
            this,
            arrayOf(Manifest.permission.WRITE_EXTERNAL_STORAGE, Manifest.permission.READ_EXTERNAL_STORAGE),
            REQUEST_STORAGE_PERMISSION
        )
    } else {
        // 权限到手，执行文件创建逻辑
        createFileInExternalStorage()
    }
}

// 处理权限申请结果
override fun onRequestPermissionsResult(
    requestCode: Int,
    permissions: Array<out String>,
    grantResults: IntArray
) {
    super.onRequestPermissionsResult(requestCode, permissions, grantResults)
    if (requestCode == REQUEST_STORAGE_PERMISSION) {
        if (grantResults.isNotEmpty() && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
            createFileInExternalStorage()
        } else {
            Log.e("TAG", "存储权限被拒绝啦，没法创建文件")
        }
    }
}

把你原来的文件创建代码放到createFileInExternalStorage()里，确保只有权限通过后才执行。

3. 目录创建后有没有确认成功？ #

你代码里只调用了directory?.mkdirs()，但没检查返回值，这很容易踩坑！建议加上判断：

try {
    val isDirCreated = directory?.mkdirs()
    if (isDirCreated == false) {
        Log.e("TAG", "目录创建失败，大概率是权限不够或者路径有问题")
        return
    }
    // 接下来创建具体文件
    file = File(directory, "your_secret_file.txt") // 替换成你要的文件名
    val isFileCreated = file?.createNewFile()
    if (isFileCreated == false) {
        Log.e("TAG", "文件创建失败，可能已经存在或者权限没到位")
    } else {
        Log.d("TAG", "文件创建成功啦！路径：${file?.absolutePath}")
    }
} catch (e: SecurityException) {
    Log.e("TAG", "安全异常：${e.message}")
} catch (e: IOException) {
    Log.e("TAG", "IO异常：${e.message}")
}

这里mkdirs()会创建所有不存在的父目录，比mkdir()好用，但一定要检查返回值确认是否真的创建成功。

4. 路径是不是写错了？ #

可以先打印一下目录的绝对路径，看看是不是符合预期：

Log.d("TAG", "目标目录路径：${directory?.absolutePath}")

有时候可能因为拼写错误、大小写问题或者特殊字符导致路径无效，打印出来一看就清楚了。

5. 高版本Android的替代方案：Scoped Storage #

要是不想依赖requestLegacyExternalStorage这种兼容手段，推荐用Scoped Storage来访问公共文档目录，比如用MediaStore创建文件，这样更符合Android的最新规范，还不用申请传统的读写权限：

val contentValues = ContentValues().apply {
    put(MediaStore.Documents.Document.COLUMN_DISPLAY_NAME, "your_secret_file.txt")
    put(MediaStore.Documents.Document.COLUMN_MIME_TYPE, "text/plain")
    put(MediaStore.Documents.Document.COLUMN_RELATIVE_PATH, Environment.DIRECTORY_DOCUMENTS + "/SecretsApp")
}

val uri = contentResolver.insert(MediaStore.Files.getContentUri("external"), contentValues)
uri?.let {
    contentResolver.openOutputStream(it).use { outputStream ->
        // 在这里写入文件内容，比如：
        outputStream?.write("我的秘密内容".toByteArray())
        Log.d("TAG", "文件创建成功！")
    }
} ?: Log.e("TAG", "文件创建失败了")

建议你先从权限配置和动态申请查起，再加上目录和文件创建的结果判断，很快就能定位到具体是哪一步出问题啦。

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