三星Tab S8系列设备ExternalFilesDir随机写入失败问题求助

在三星Tab S8/S8+/S8 Ultra设备上（Saucelab环境可复现，本地设备无此问题），向getExternalFilesDir(null)下的子目录创建文件时，随机抛出java.io.IOException: Permission denied异常，应用配置minSdkVersion 23、targetSdkVersion 32，按Android官方文档，该路径无需申请外部存储权限。以下是具体排查方向和解决方案：

1. 修正文件操作逻辑的竞态问题 #

原代码中先判断exists()再调用mkdirs()的方式存在竞态条件——判断和创建操作之间，目录状态可能被系统服务或其他进程修改。建议直接调用mkdirs()并结合事后检查，确保目录存在且可写，同时增加重试机制应对随机异常：

private fun startTest() {
    try {
        runOnUiThread{
            resultAsString += "\ngetExternalFilesDir..."
            resultText!!.text = resultAsString
        }

        val documents = File(applicationContext.getExternalFilesDir(null), "documents")
        // 直接创建目录，若已存在则通过exists()验证，同时检查可写性
        val documentsAccessible = (documents.mkdirs() || documents.exists()) && documents.canWrite()

        val fileFolder = File(documents, "testFolder")
        val fileFolderAccessible = (fileFolder.mkdirs() || fileFolder.exists()) && fileFolder.canWrite()

        if(documentsAccessible) {
            val txtFile = File(documents, "readme.txt")
            var createSuccess = false
            var retryCount = 0
            val maxRetries = 3
            // 针对随机异常增加重试逻辑
            while (!createSuccess && retryCount < maxRetries) {
                try {
                    createSuccess = txtFile.createNewFile() || txtFile.exists()
                    break
                } catch (e: IOException) {
                    retryCount++
                    Thread.sleep(500)
                }
            }
            runOnUiThread{
                resultAsString += if (createSuccess) "\nTest performed successfully" else "\nFailed to create file after retries"
                resultText!!.text = resultAsString
            }
        }else{
            runOnUiThread{
                resultAsString += "\nDocuments Folder not accessible or not writable"
                resultText!!.text = resultAsString
            }
        }
    } catch (e: Exception) {
        // 增加目录状态日志辅助排查
        val dirInfo = "Documents dir exists: ${documents.exists()}, writable: ${documents.canWrite()}, path: ${documents.absolutePath}"
        val errorLog = "\nError: ${e.message}\nDir info: $dirInfo"
        runOnUiThread{
            resultAsString += errorLog
            resultText!!.text = resultAsString
            resultButton!!.text = "Error"
            resultButton!!.visibility = View.VISIBLE
        }
        e.printStackTrace()
    }
}

2. 排查Saucelab设备的特殊配置 #

Saucelab的测试设备可能启用了设备所有者模式、企业管理策略或三星特定安全限制，这些会限制应用对私有外部存储的访问：

• 检查Saucelab设备配置是否有特殊权限限制，比如禁用了应用存储访问权限（三星定制系统可能有文档外的例外规则）
• 尝试在Saucelab设备上手动启动应用，观察是否有系统弹窗提示权限请求（可能被自动化测试环境忽略）

3. 适配三星定制系统的存储机制 #

三星设备的My Files应用或系统存储优化服务可能在后台扫描/锁定应用私有外部存储目录，导致临时权限拒绝：

• 避免频繁创建/删除目录，减少触发系统扫描的概率
• 改用系统标准文档目录替代手动创建documents目录，兼容性更好：

  val documents = applicationContext.getExternalFilesDir(Environment.DIRECTORY_DOCUMENTS)!!
  

4. 检查目标SDK版本的适配细节 #

尽管targetSdkVersion 32，仍需确认：

• AndroidManifest中是否错误声明了READ_EXTERNAL_STORAGE或WRITE_EXTERNAL_STORAGE权限，建议移除这些不必要的权限（私有外部存储无需申请）
• 确认应用未开启MANAGE_EXTERNAL_STORAGE权限，该权限会改变存储访问逻辑，可能引发冲突

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