Jetpack Compose Coil相册图片缓存与本地加载问题咨询

你当前用的是Jetpack Compose的Coil组件加载本地相册图片，Coil默认只对网络图片做缓存，本地文件默认不会走缓存逻辑。要实现本地图片的内存+磁盘缓存，按以下步骤配置：

1. 全局初始化ImageLoader（推荐） #

先在Application里创建全局的ImageLoader实例，统一管理缓存配置，避免每个页面重复设置：

class MyApp : Application() {
    companion object {
        lateinit var imageLoader: ImageLoader
    }

    override fun onCreate() {
        super.onCreate()
        imageLoader = ImageLoader.Builder(this)
            // 配置内存缓存：占用应用可用内存的25%，可根据需求调整
            .memoryCache {
                MemoryCache.Builder(this)
                    .maxSizePercent(0.25)
                    .build()
            }
            // 配置磁盘缓存：指定缓存目录，设置512MB上限
            .diskCache {
                DiskCache.Builder()
                    .directory(cacheDir.resolve("coil_local_images"))
                    .maxSizeBytes(512 * 1024 * 1024)
                    .build()
            }
            // 全局拦截本地文件请求，自动启用缓存
            .components {
                add(LocalFileCacheInterceptor)
            }
            .build()
    }
}

// 自定义拦截器：识别本地文件路径，自动设置缓存策略和唯一缓存Key
object LocalFileCacheInterceptor : Interceptor {
    override suspend fun intercept(chain: Interceptor.Chain): ImageResult {
        val request = chain.request
        // 判断是否是本地文件路径（以/开头的绝对路径）
        if (request.data is String && (request.data as String).startsWith("/")) {
            val fileKey = "local_img_${request.data.hashCode()}"
            val cachedRequest = request.newBuilder()
                // 启用内存+磁盘缓存
                .memoryCachePolicy(CachePolicy.ENABLED)
                .diskCachePolicy(CachePolicy.ENABLED)
                // 设置唯一缓存Key，确保同一张图片复用缓存
                .memoryCacheKey(fileKey)
                .diskCacheKey(fileKey)
                .build()
            return chain.proceed(cachedRequest)
        }
        return chain.proceed(request)
    }
}

2. 在Compose中使用配置好的ImageLoader #

之后在加载图片时，直接用全局的ImageLoader，不用再单独配置每个请求：

val model = ImageRequest.Builder(current)
    .data(asset.path)
    .crossfade(true)
    .build()

AsyncImage(
    model = model,
    contentDescription = "image",
    imageLoader = MyApp.imageLoader
)

3. 手动配置单个请求（如果不需要全局配置） #

如果不想全局初始化ImageLoader，也可以单独给每个请求设置缓存：

val model = ImageRequest.Builder(current)
    .data(asset.path)
    .crossfade(true)
    // 启用内存和磁盘缓存
    .memoryCachePolicy(CachePolicy.ENABLED)
    .diskCachePolicy(CachePolicy.ENABLED)
    // 设置唯一缓存Key，用文件路径的哈希值保证唯一性
    .memoryCacheKey("local_img_${asset.path.hashCode()}")
    .diskCacheKey("local_img_${asset.path.hashCode()}")
    .build()

// 这里可以用默认ImageLoader，也可以自定义
AsyncImage(
    model = model,
    contentDescription = "image"
)

验证缓存生效 #

• 加载图片后，再次加载同一张图片，查看Coil的日志（过滤"Coil"关键词），会看到"Memory cache hit"或"Disk cache hit"的日志，说明缓存生效
• 可以去应用的缓存目录（Android/data/你的包名/cache/coil_local_images）查看生成的缓存文件

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