Android中MediaStore.Images.Thumbnails.getThumbnail返回null问题求助

我来帮你排查这个问题，你遇到的getThumbnail返回null的情况，大概率是因为解析图片ID的方式有误，咱们一步步拆解原因和解决方案：

为什么原来的代码会返回null？ #

你当前是直接从Uri的pathSegments取最后一段作为图片ID，但这个逻辑有个致命问题：不同图库应用返回的Uri格式并不统一。比如：

• 系统图库可能返回content://media/external/images/media/1234，此时最后一段确实是MediaStore的图片ID；
• 但第三方图库或文件管理器可能返回content://com.android.providers.media.documents/document/image%3A1234，这时候最后一段是image%3A1234，转成Long后完全不是正确的图片ID；
• 甚至有些Uri根本不指向MediaStore的条目，自然找不到对应的缩略图。

另外，MediaStore.Images.Thumbnails.getThumbnail本身是个过时的API（API 29开始被废弃），它依赖系统已经生成的缩略图缓存，如果图片还没生成缩略图，也会返回null。

正确的解决方案 #

方案1：正确获取MediaStore图片ID，再调用getThumbnail #

先通过ContentResolver查询获取真实的MediaStore图片ID，而不是直接解析Uri路径：

override fun onActivityResult(requestCode: Int, resultCode: Int, responseData: Intent?) {
    when (requestCode) {
        MENU_PICK_IMAGE -> if (resultCode == Activity.RESULT_OK) {
            responseData?.data?.let { contentUri ->
                val imageId = getImageIdFromUri(contentUri)
                imageId?.let { id ->
                    val thumbnail = MediaStore.Images.Thumbnails.getThumbnail(
                        contentResolver,
                        id,
                        MediaStore.Images.Thumbnails.MINI_KIND,
                        null
                    )
                    // 处理缩略图
                }
            }
        }
    }
}

// 辅助方法：从Uri获取MediaStore图片ID
private fun getImageIdFromUri(uri: Uri): Long? {
    var imageId: Long? = null
    // 处理DocumentsContract类型的Uri（比如文件管理器返回的）
    if (DocumentsContract.isDocumentUri(this, uri)) {
        val docId = DocumentsContract.getDocumentId(uri)
        if ("com.android.providers.media.documents" == uri.authority) {
            // 分割docId，格式通常是 "image:1234"
            val split = docId.split(":")
            if (split.size == 2 && split[0] == "image") {
                imageId = split[1].toLong()
            }
        }
    } else if ("content" == uri.scheme) {
        // 直接查询MediaStore获取ID
        val projection = arrayOf(MediaStore.Images.Media._ID)
        contentResolver.query(uri, projection, null, null, null)?.use { cursor ->
            if (cursor.moveToFirst()) {
                val idColumn = cursor.getColumnIndexOrThrow(MediaStore.Images.Media._ID)
                imageId = cursor.getLong(idColumn)
            }
        }
    }
    return imageId
}

方案2：直接解码原图生成缩略图（更可靠） #

跳过系统缩略图缓存，直接通过Uri加载原图并缩小生成缩略图，这种方法不依赖系统缓存，兼容性更好：

override fun onActivityResult(requestCode: Int, resultCode: Int, responseData: Intent?) {
    when (requestCode) {
        MENU_PICK_IMAGE -> if (resultCode == Activity.RESULT_OK) {
            responseData?.data?.let { contentUri ->
                contentResolver.openInputStream(contentUri)?.use { inputStream ->
                    val options = BitmapFactory.Options().apply {
                        // 设置采样率，比如缩小4倍，数值越大缩略图越小
                        inSampleSize = 4
                        // 只解析边界信息，避免加载全图到内存
                        inJustDecodeBounds = false
                    }
                    val thumbnail = BitmapFactory.decodeStream(inputStream, null, options)
                    // 处理生成的缩略图
                }
            }
        }
    }
}

方案3：使用ThumbnailUtils（推荐） #

如果你的Target SDK是28，可以用ThumbnailUtils的工具方法，它内部已经处理了各种情况：

import android.media.ThumbnailUtils

override fun onActivityResult(requestCode: Int, resultCode: Int, responseData: Intent?) {
    when (requestCode) {
        MENU_PICK_IMAGE -> if (resultCode == Activity.RESULT_OK) {
            responseData?.data?.let { contentUri ->
                // 先获取图片真实路径（需要处理不同Uri格式）
                val imagePath = getRealPathFromUri(contentUri)
                imagePath?.let { path ->
                    val thumbnail = ThumbnailUtils.createImageThumbnail(
                        path,
                        MediaStore.Images.Thumbnails.MINI_KIND
                    )
                    // 处理缩略图
                }
            }
        }
    }
}

// 辅助方法：从Uri获取图片真实路径
private fun getRealPathFromUri(uri: Uri): String? {
    var path: String? = null
    if ("content" == uri.scheme) {
        val projection = arrayOf(MediaStore.Images.Media.DATA)
        contentResolver.query(uri, projection, null, null, null)?.use { cursor ->
            if (cursor.moveToFirst()) {
                val dataColumn = cursor.getColumnIndexOrThrow(MediaStore.Images.Media.DATA)
                path = cursor.getString(dataColumn)
            }
        }
    } else if ("file" == uri.scheme) {
        path = uri.path
    }
    return path
}

额外提示 #

• 尽量避免使用过时的MediaStore.Images.Thumbnails.getThumbnail，后续升级Target SDK到29+后这个方法会被移除；
• 如果你的项目里已经用了图片加载库（比如Glide、Picasso），直接用它们加载Uri生成缩略图会更省心，还能自动处理缓存和内存优化。

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