从Android外部存储获取截图文件夹图片失败排查

原代码的核心问题 #

1. MediaStore.Images.Media.DATA已废弃：从Android Q（API 29）开始，该字段不再返回真实文件路径，高版本系统中可能返回空值，导致Cursor无数据。
2. 固定路径匹配不兼容：不同厂商设备的截图路径可能不同，比如部分设备是Pictures/Screenshots，仅匹配DCIM/Screenshots会遗漏图片。
3. 权限未适配：Android 13+需要READ_MEDIA_IMAGES权限，低于13版本需要READ_EXTERNAL_STORAGE，未正确申请权限会导致查询无结果。

修正后的代码（兼容全版本） #

1. 权限配置

首先在AndroidManifest.xml中添加权限：

<!-- Android 13+ -->
<uses-permission android:name="android.permission.READ_MEDIA_IMAGES" />
<!-- Android 12及以下 -->
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" android:maxSdkVersion="32" />

2. 动态申请权限（Compose环境）

val permissionState = rememberPermissionState(
    permission = if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU) {
        Manifest.permission.READ_MEDIA_IMAGES
    } else {
        Manifest.permission.READ_EXTERNAL_STORAGE
    }
)

LaunchedEffect(Unit) {
    permissionState.launchPermissionRequest()
}

3. 正确查询截图文件

val context = LocalContext.current
val screenshots = mutableListOf<Uri>()

// 针对API 29+使用RELATIVE_PATH，低版本兼容DATA字段
val projection = if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
    arrayOf(
        MediaStore.Images.Media._ID,
        MediaStore.Images.Media.RELATIVE_PATH
    )
} else {
    arrayOf(
        MediaStore.Images.Media._ID,
        MediaStore.Images.Media.DATA
    )
}

val (selection, selectionArgs) = if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
    // API 29+用RELATIVE_PATH匹配所有含Screenshots的路径
    "${MediaStore.Images.Media.RELATIVE_PATH} LIKE ?" to arrayOf("%Screenshots%")
} else {
    // 低版本匹配两种常见截图路径
    "${MediaStore.Images.Media.DATA} LIKE ? OR ${MediaStore.Images.Media.DATA} LIKE ?" 
        to arrayOf("%/DCIM/Screenshots%", "%/Pictures/Screenshots%")
}

val sortOrder = "${MediaStore.Images.Media.DATE_MODIFIED} DESC"

context.contentResolver.query(
    MediaStore.Images.Media.EXTERNAL_CONTENT_URI,
    projection,
    selection,
    selectionArgs,
    sortOrder
)?.use { cursor ->
    val idColumn = cursor.getColumnIndexOrThrow(MediaStore.Images.Media._ID)
    while (cursor.moveToNext()) {
        val id = cursor.getLong(idColumn)
        // 用ContentUri替代真实路径，兼容高版本权限限制
        val contentUri = ContentUris.withAppendedId(MediaStore.Images.Media.EXTERNAL_CONTENT_URI, id)
        screenshots.add(contentUri)
    }
}

关键改进点 #

• 用RELATIVE_PATH（API 29+）替代废弃的DATA字段，适配系统权限变更。
• 模糊匹配所有含Screenshots的路径，兼容不同厂商的存储布局。
• 使用ContentUri而非真实文件路径，避免高版本系统的文件访问限制。
• 用getColumnIndexOrThrow确保字段存在，避免潜在崩溃。

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