Jetpack Compose中Coil无法加载特定网站图片问题求助

问题原因 #

该图片所属网站（static.lightnovelworld.com）大概率启用了Referer防盗链校验：服务器会检查请求的Referer头，仅允许来自其官网（如lightnovelworld.com）的请求加载图片，而App默认请求未携带合法Referer，因此被服务器拒绝返回图片，导致Coil/Glide加载失败。

解决方案：为Coil添加自定义请求头拦截器 #

通过给Coil的OkHttp客户端添加拦截器，模拟携带合法的Referer（或User-Agent）头，即可绕过防盗链校验。

1. 定义自定义拦截器

class ImageRefererInterceptor : Interceptor {
    override fun intercept(chain: Interceptor.Chain): Response {
        val modifiedRequest = chain.request().newBuilder()
            // 添加目标网站的Referer，模拟从官网页面发起请求
            .addHeader("Referer", "https://lightnovelworld.com/")
            // 可选：添加浏览器风格的User-Agent，避免被识别为非客户端请求
            .addHeader("User-Agent", "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/118.0.0.0 Safari/537.36")
            .build()
        return chain.proceed(modifiedRequest)
    }
}

2. 全局配置Coil（推荐）

在Application类中初始化Coil时，注入带拦截器的OkHttp客户端：

class MyApplication : Application() {
    override fun onCreate() {
        super.onCreate()
        val okHttpClient = OkHttpClient.Builder()
            .addInterceptor(ImageRefererInterceptor())
            .build()
        
        Coil.setImageLoader(
            ImageLoader.Builder(this)
                .okHttpClient(okHttpClient)
                .build()
        )
    }
}

3. 单个请求配置（可选）

如果仅需针对特定图片请求生效，可在AsyncImage中指定自定义ImageLoader：

@Composable
fun BookItem(
    title: String,
    cover: String?,
    unreadChapters: Int,
) {
    val context = LocalContext.current
    // 局部创建带拦截器的ImageLoader
    val customImageLoader = remember {
        ImageLoader.Builder(context)
            .okHttpClient(
                OkHttpClient.Builder()
                    .addInterceptor(ImageRefererInterceptor())
                    .build()
            )
            .build()
    }

    Box(
        modifier = Modifier.wrapContentSize(),
        contentAlignment = Alignment.Center
    ) {
        AsyncImage(
            model = ImageRequest.Builder(context)
                .data(cover)
                .crossfade(true)
                .build(),
            contentDescription = title,
            contentScale = ContentScale.Inside,
            modifier = Modifier
                .clip(RoundedCornerShape(12.dp))
                .size(200.dp),
            imageLoader = customImageLoader
        )
    }
}

验证方法 #

可以用curl命令验证防盗链规则：

• 不带Referer请求（会返回403）：

  curl -I https://static.lightnovelworld.com/bookcover/300x400/01365-shadow-slave.jpg
  

• 携带合法Referer请求（会返回200）：

  curl -I -H "Referer: https://lightnovelworld.com/" https://static.lightnovelworld.com/bookcover/300x400/01365-shadow-slave.jpg
  

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