使用Coil在LazyColumn加载GIF，重组时无法立即加载的问题

核心问题分析 #

重组时GIF无法立即加载，通常是由于ImageRequest重复创建、缓存未命中、缓存被回收或GIF播放状态未恢复导致的。以下是针对性的解决步骤：

1. 用remember稳定ImageRequest，避免重复创建 #

每次重组时重新生成ImageRequest会触发Coil重新发起请求，即使缓存存在也可能重新加载。用remember包裹请求创建逻辑，仅当URL变化时才重新生成：

val imageData = remember(original.url) {
    ImageRequest.Builder(LocalContext.current)
        .data(original.url)
        .size(Size.ORIGINAL)
        .memoryCacheKey(original.url) // 明确内存缓存键，确保缓存命中
        .diskCacheKey(original.url)   // 明确磁盘缓存键
        .memoryCachePolicy(CachePolicy.ENABLED)
        .diskCachePolicy(CachePolicy.ENABLED)
        .build()
}

2. 优化ImageLoader缓存配置，防止缓存被回收 #

调整内存/磁盘缓存占比，并启用强引用缓存，避免GIF缓存被系统回收：

val imageLoader = ImageLoader.Builder(context)
    .memoryCachePolicy(CachePolicy.ENABLED)
    .diskCachePolicy(CachePolicy.ENABLED)
    .components {
        if (SDK_INT >= 28) {
            add(ImageDecoderDecoder.Factory())
        } else {
            add(GifDecoder.Factory())
        }
    }
    .diskCache(
        DiskCache.Builder()
            .directory(context.cacheDir.resolve("image_cache"))
            .maxSizePercent(0.25) // 调小占比，避免过度占用存储
            .build()
    )
    .memoryCache(
        MemoryCache.Builder(context)
            .maxSizePercent(0.25) // 调小内存占比，降低OOM风险
            .strongReferencesEnabled(true) // 启用强引用，防止缓存被GC回收
            .build()
    )
    .build()

3. 确保ImageLoader全局单例，共享缓存 #

不要在LazyColumn项内创建ImageLoader，全局单例才能保证缓存共享。用CompositionLocal提供全局实例：

// 定义全局CompositionLocal
val LocalImageLoader = staticCompositionLocalOf<ImageLoader> {
    error("ImageLoader未初始化")
}

// 在Activity/Compose根节点提供实例
val imageLoader = remember {
    // 上述优化后的ImageLoader配置
}
CompositionLocalProvider(LocalImageLoader provides imageLoader) {
    // 你的页面内容（包含LazyColumn）
}

// 在LazyColumn项内使用
SubcomposeAsyncImage(
    imageLoader = LocalImageLoader.current,
    // 其他参数
)

4. 强制恢复GIF播放状态 #

重组后GifPainter可能暂停播放，在success回调中手动启动：

success = { state ->
    val painter = state.painter
    if (painter is GifPainter && !painter.isRunning) {
        painter.start()
    }
    Image(
        painter = painter,
        contentDescription = "GIF Image",
        alignment = Alignment.Center,
        contentScale = ContentScale.Fit,
    )
}

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