浏览器可正常显示的图片在Coil Compose中无法加载求助

以下是针对该问题的具体排查和解决方向：

• 检查URL编码一致性
  浏览器会自动处理URL中的特殊字符（如%2B这类转义符），但Coil依赖的HTTP客户端可能不会自动兼容。尝试手动对URL进行UTF-8编码后再传入Coil，比如在Kotlin中使用Uri.encode(imageUrl)处理完整URL。

• 验证AWS签名有效性
  该图片URL包含AWS临时签名参数（X-Amz-Security-Token、X-Amz-Date等），其中X-Amz-Expires=3600表示签名1小时后过期。确认请求时签名是否仍在有效期内，若为缓存的旧URL，需重新从Edamam API获取最新的带签名URL。

• 自定义Coil的HTTP客户端请求头
  浏览器请求会自动携带User-Agent等头信息，而Coil默认客户端可能缺失必要头导致S3拒绝请求。可以自定义OkHttpClient添加请求头：

  val okHttpClient = OkHttpClient.Builder()
      .addInterceptor { chain ->
          val request = chain.request().newBuilder()
              .header("User-Agent", "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/124.0.0.0 Safari/537.36")
              .build()
          chain.proceed(request)
      }
      .build()
  
  val imageLoader = ImageLoader.Builder(context)
      .okHttpClient(okHttpClient)
      .build()
  

• 确认应用网络权限
  检查AndroidManifest.xml中是否添加了网络权限：

  <uses-permission android:name="android.permission.INTERNET" />
  

  Android 9及以上版本需确保网络安全策略允许访问该S3域名（HTTPS协议无需额外配置明文访问）。

• 排查SSL证书信任问题
  部分情况下Coil的OkHttpClient可能不信任S3的SSL证书，可临时禁用证书验证（仅用于调试，生产环境禁止）：

  val unsafeOkHttpClient = OkHttpClient.Builder()
      .sslSocketFactory(SSLSocketFactory.getDefault() as SSLSocketFactory, X509TrustManager.getDefault() as X509TrustManager)
      .hostnameVerifier { _, _ -> true }
      .build()
  

• 查看Coil错误日志定位问题
  启用Coil调试日志或监听加载错误获取具体异常信息：

  // 启用日志
  val imageLoader = ImageLoader.Builder(context)
      .logger(DebugLogger())
      .build()
  
  // 监听加载错误
  imageView.load(imageUrl) {
      listener(
          onError = { request, throwable ->
              Log.e("CoilLoadError", "失败原因: ${throwable.message}")
          }
      )
  }
  

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