为何添加磁盘缓存后Coil图片加载速度大幅变慢？

核心问题：重复创建ImageLoader实例 #

你在UserAvatar Composable中每次调用getAsyncImageLoader()都会新建一个全新的ImageLoader，这会导致：

• 每个AsyncImage拥有独立的内存/磁盘缓存，无法共享缓存内容，等于白加缓存
• 重复初始化缓存目录、线程池等资源，带来巨大的性能开销，这是加载变慢的主要原因

Coil的ImageLoader设计为全局单例，应该在应用启动时初始化一次，全局复用。

其他优化点 #

1. 磁盘缓存目录错误：使用系统临时目录SYSTEM_TEMPORARY_DIRECTORY，该目录IO性能差且可能被系统自动清理，应改用应用私有缓存目录。
2. 手动设置缓存键冗余：Coil默认会根据请求数据生成唯一缓存键，手动设置memoryCacheKey和diskCacheKey可能导致缓存逻辑混乱，除非你有特殊需求，否则无需手动指定。
3. 内存缓存配置过度：strongReferencesEnabled(true)和weakReferencesEnabled(true)会增加内存压力，触发频繁GC，Coil默认配置已经足够高效。

修改后的代码示例 #

1. 全局初始化ImageLoader（推荐放在Application类中）

// 全局单例ImageLoader
val coilImageLoader by lazy {
    ImageLoader.Builder(PlatformContext.INSTANCE)
        .memoryCachePolicy(CachePolicy.ENABLED)
        .diskCachePolicy(CachePolicy.ENABLED)
        .memoryCache(
            MemoryCache.Builder()
                .maxSizePercent(PlatformContext.INSTANCE, 0.2) // 调整为更合理的内存占比，默认是0.25
                .build()
        )
        .diskCache(
            DiskCache.Builder()
                .directory(File(PlatformContext.INSTANCE.cacheDir, "image_cache")) // 应用私有缓存目录
                .maxSizeBytes(512 * 1024 * 1024) // 512MB，修正为标准单位换算
                .build()
        )
        .logger(DebugLogger())
        .build()
}

2. 修改UserAvatar Composable，复用全局ImageLoader

@Composable
fun UserAvatar(
    avatar: CommunityImage,
    contentScale: ContentScale = ContentScale.Fit,
    modifier: Modifier = Modifier,
) {
    AsyncImage(
        model = ImageRequest.Builder(PlatformContext.INSTANCE)
            .data(avatar) // 修正原代码中未使用传入的avatar参数问题
            .error { MR.images.ic_avatar_preview.image.toBitmap().asImage() }
            .crossfade(enable = true)
            .build(),
        contentDescription = "用户头像", // 添加有意义的无障碍描述
        modifier = modifier,
        imageLoader = coilImageLoader, // 使用全局单例ImageLoader
        contentScale = contentScale,
    )
}

额外调试建议 #

• 查看DebugLogger输出的日志，确认缓存命中状态，验证是否从磁盘/内存缓存加载图片
• 检查图片URL是否带有动态参数（如时间戳），这类参数会导致缓存键变化，无法命中已有缓存

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