Android Compose AsyncImage为何无法加载www开头URL图片？求解决方法

为什么会失败？ #

AsyncImage默认依赖Coil库做图片加载，而Coil要求URL必须带完整的http/https协议头。像www.xxx.com/pic.jpg这种没有协议的地址，库无法识别要使用的网络协议，会直接判定为无效URL，导致加载失败。

怎么解决？ #

1. 手动补全协议头（最简单直接） #

在传入AsyncImage之前，给URL补上https协议头就行，写个工具函数统一处理：

fun fixWwwUrl(url: String): String {
    return if (url.startsWith("www.") && !url.startsWith("http")) {
        "https://$url"
    } else {
        url
    }
}

// 使用时直接调用工具函数
AsyncImage(
    model = fixWwwUrl("www.example.com/test.jpg"),
    contentDescription = "测试图片"
)

2. 让Coil自动处理（一劳永逸） #

如果有大量这类URL需要处理，不想每次手动补全，可以自定义Coil的UrlDecoder，让它自动补全协议：

class WwwAutoFixDecoder(private val delegate: UrlDecoder) : UrlDecoder by delegate {
    override fun decode(url: String, headers: Headers): HttpUrl {
        val fixedUrl = if (url.startsWith("www.") && !url.startsWith("http")) {
            "https://$url"
        } else {
            url
        }
        return delegate.decode(fixedUrl, headers)
    }
}

// 初始化Coil时配置自定义解码器
val customImageLoader = ImageLoader.Builder(context)
    .components {
        add { decoder: UrlDecoder -> WwwAutoFixDecoder(decoder) }
    }
    .build()

// Compose中使用这个自定义的ImageLoader
AsyncImage(
    model = "www.example.com/test.jpg",
    contentDescription = "测试图片",
    imageLoader = customImageLoader
)

3. 从源头解决（最省心） #

如果是后端返回的URL不带协议，直接和后端开发沟通，让他们返回完整的带http/https的URL，彻底避免这类格式问题。

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