Jetpack Compose Coil-AsyncImage：URI不变时如何刷新/重载图片

方案1：给URI添加随机查询参数（缓存击穿） #

利用服务端忽略无关查询参数的特性，给原URI附加唯一标识（比如时间戳、版本号），让AsyncImage识别为新资源，触发重新请求：

val baseAvatarUrl = "https://your-domain.com/user/avatar"
// 上传成功后生成带时间戳的URL
val refreshableAvatarUrl = "$baseAvatarUrl?refresh=${System.currentTimeMillis()}"

AsyncImage(
    model = refreshableAvatarUrl,
    contentDescription = "用户头像"
)

大部分后端框架默认会忽略未定义的查询参数，不会影响资源获取。

方案2：自定义ImageRequest，强制跳过缓存并设置唯一key #

通过ImageRequest配置禁用缓存，同时用可变状态作为请求key，确保上传成功后触发新请求：

val context = LocalContext.current
val baseAvatarUrl = "https://your-domain.com/user/avatar"
// 用状态变量标记头像版本，上传成功后更新
var avatarVersion by remember { mutableStateOf(0) }

AsyncImage(
    model = ImageRequest.Builder(context)
        .data(baseAvatarUrl)
        // 禁用内存和磁盘缓存
        .memoryCachePolicy(CachePolicy.DISABLED)
        .diskCachePolicy(CachePolicy.DISABLED)
        // 用版本号作为请求唯一标识，版本更新则触发新请求
        .key("user-avatar-$avatarVersion")
        .build(),
    contentDescription = "用户头像"
)

// 头像上传成功后执行此代码更新版本
// avatarVersion++

方案3：手动清除Coil对应URI的缓存 #

上传成功后直接清除该URI在Coil内存和磁盘中的缓存，再触发重组让AsyncImage重新加载：

val context = LocalContext.current
val baseAvatarUrl = "https://your-domain.com/user/avatar"
// 用状态变量触发重组
var shouldRefreshAvatar by remember { mutableStateOf(false) }

AsyncImage(
    model = baseAvatarUrl,
    contentDescription = "用户头像",
    // 依赖状态变量，值变化时触发重组
    modifier = Modifier.animateContentSize()
)

// 上传成功后调用
LaunchedEffect(shouldRefreshAvatar) {
    if (shouldRefreshAvatar) {
        val imageLoader = context.imageLoader
        // 清除对应URI的缓存
        imageLoader.diskCache?.remove(baseAvatarUrl)
        imageLoader.memoryCache?.remove(baseAvatarUrl)
        // 重置状态，避免重复清除
        shouldRefreshAvatar = false
    }
}

// 触发刷新的调用：shouldRefreshAvatar = true

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