Android RecyclerView Adapter图片加载卡顿及API重复调用问题排查

现有实现是否正确？ #

不正确。核心问题集中在三点：

• 未给Coil设置与图片ID绑定的唯一缓存标识，导致缓存机制失效，每次滚动都重复发起API请求
• 可能在主线程执行API调用或base64解码操作，阻塞UI线程引发滚动卡顿
• 未配合RecyclerView的视图复用机制处理请求生命周期，无用请求持续消耗资源

修复步骤 #

1. 给Coil绑定基于图片ID的缓存Key #

Coil通过请求的唯一Key识别缓存，必须将图片ID作为缓存标识，让Coil能直接复用已缓存的图片，无需重复请求。

示例代码：

// 在Adapter的onBindViewHolder方法中
val imageId = list[position].imageId
val request = ImageRequest.Builder(itemView.context)
    .data(ImageIdDataSource(imageId))
    .target(holder.imageView)
    .memoryCacheKey(imageId) // 指定内存缓存Key
    .diskCacheKey(imageId) // 指定磁盘缓存Key
    .build()
imageLoader.enqueue(request)

2. 自定义Coil DataSource封装双API逻辑 #

把“通过ID请求base64→解码Bitmap”的逻辑封装到Coil的DataSource中，让Coil统一管理请求和缓存，避免手动处理导致的缓存失效。

示例自定义DataSource：

class ImageIdDataSource(private val imageId: String) : DataSource {
    override suspend fun fetch(): ImageResult {
        // 1. 后台线程调用API获取base64编码
        val base64Str = apiService.getImageBase64(imageId)
        // 2. 后台线程解码base64为Bitmap
        val bitmapBytes = Base64.decode(base64Str, Base64.DEFAULT)
        val bitmap = BitmapFactory.decodeByteArray(bitmapBytes, 0, bitmapBytes.size)
        return ImageResult.Success(bitmap, emptyMap())
    }

    override fun key(): String = imageId // 关键：返回与图片ID绑定的唯一Key
}

3. 避免主线程阻塞 #

Coil的fetch方法是挂起函数，默认在后台线程执行，将API调用和解码逻辑放在这里，可彻底避免阻塞UI线程，解决滚动卡顿问题。

4. 配合视图复用取消无用请求 #

在Adapter中重写onViewRecycled方法，取消当前ImageView的未完成请求，减少资源浪费：

override fun onViewRecycled(holder: ViewHolder) {
    super.onViewRecycled(holder)
    imageLoader.cancel(holder.imageView)
}

5. 确认Coil缓存配置有效 #

检查自定义ImageLoader是否开启了缓存（默认开启），若有自定义配置需确保缓存开关未被禁用：

val imageLoader = ImageLoader.Builder(context)
    .memoryCacheEnabled(true)
    .diskCacheEnabled(true)
    .build()

内容的提问来源于stack exchange，提问作者Dr.KeyOk