Android 10文件重命名失效问题及代码报错求助

问题根源 #

• Android 10强制启用分区存储，File类的直接文件操作（如renameTo）对外部存储的公共目录（如Music、Pictures）不再生效。
• 原代码中getIdFromDisplayName通过文件名查询MediaStore ID存在两个致命问题：
  • 存在重名文件时，查询结果可能不准确或返回null，直接用!!会触发空指针异常。
  • 若文件未被MediaStore索引（比如刚创建的非媒体文件），查询会返回null。

方案1：针对媒体文件（图片/音频/视频）的重命名 #

利用MediaStore直接更新文件元数据，无需通过文件名查ID，直接使用原始MediaStore Uri操作：

private fun renameMediaFile(mediaUri: Uri, newName: String) {
    val contentValues = ContentValues().apply {
        // 标记文件为待修改状态，防止其他应用干扰
        put(MediaStore.Files.FileColumns.IS_PENDING, 1)
    }

    // 先锁定文件
    contentResolver.update(mediaUri, contentValues, null, null)

    // 更新文件名并解除锁定
    contentValues.clear()
    contentValues.put(MediaStore.Files.FileColumns.DISPLAY_NAME, newName)
    contentValues.put(MediaStore.Files.FileColumns.IS_PENDING, 0)

    try {
        contentResolver.update(mediaUri, contentValues, null, null)
        Log.d("TAG", "重命名成功：$newName")
    } catch (e: SecurityException) {
        Log.e("TAG", "重命名失败：权限不足", e)
    }
}

关键优化点： #

• 直接使用传入的mediaUri（比如从MediaStore查询到的Uri），避免通过文件名查ID的不确定性。
• 利用IS_PENDING字段锁定文件，确保修改过程的原子性。

方案2：针对任意文件的重命名（包括非媒体文件） #

使用存储访问框架（SAF），通过用户授权的方式操作文件，适用于所有文件类型：

步骤1：启动文件选择器获取文件Uri #

private val openDocumentLauncher = registerForActivityResult(ActivityResultContracts.OpenDocument()) { uri ->
    uri?.let {
        renameFileViaSAF(it, "新文件名.txt")
    }
}

// 触发文件选择流程
fun startRenameFlow() {
    openDocumentLauncher.launch(arrayOf("*/*")) // 支持所有文件类型
}

步骤2：通过SAF执行重命名 #

private fun renameFileViaSAF(fileUri: Uri, newName: String) {
    val documentFile = DocumentFile.fromSingleUri(this, fileUri)
    documentFile?.let {
        val success = it.renameTo(newName)
        if (success) {
            Log.d("TAG", "重命名成功")
        } else {
            Log.e("TAG", "重命名失败：文件不可写或不存在")
        }
    } ?: Log.e("TAG", "无法获取文件操作实例")
}

说明： #

• SAF无需申请WRITE_EXTERNAL_STORAGE权限，用户通过文件选择器授予临时访问权限。
• 支持操作未被MediaStore索引的文件，覆盖范围更广。

原代码空指针问题修复（可选） #

如果要保留原逻辑，需修改getIdFromDisplayName避免空指针，并处理重名情况：

fun getIdFromDisplayName(displayName: String): Long? {
    val projection = arrayOf(MediaStore.Files.FileColumns._ID)
    contentResolver.query(
        MediaStore.Files.getContentUri("external"),
        projection,
        "${MediaStore.Files.FileColumns.DISPLAY_NAME} = ?",
        arrayOf(displayName),
        null
    )?.use { cursor ->
        if (cursor.moveToFirst()) {
            return cursor.getLong(cursor.getColumnIndexOrThrow(projection[0]))
        }
    }
    return null
}

// 在renameOperation中调用时处理null
val fileId = getIdFromDisplayName(returnCursor.getString(nameIndex))
if (fileId != null) {
    val fromUri = ContentUris.withAppendedId(MediaStore.Files.getContentUri("external"), fileId)
    // 执行后续更新操作
} else {
    Log.e("TAG", "未找到对应文件的MediaStore ID")
    // 可 fallback 到SAF方案
}

注意事项 #

• Android 10中，应用私有目录（getExternalFilesDir()）仍可使用File类操作，公共目录必须用MediaStore或SAF。
• 修改其他应用创建的文件时，MediaStore可能无权限，需优先使用SAF。

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