Jetpack Compose使用painterResource加载资源抛出IllegalArgumentException

问题根因 #

崩溃和Coil网络图片加载逻辑无关，异常由painterResource方法抛出。
报错信息Only VectorDrawables and rasterized asset types are supported ex. PNG, JPG的含义是：Compose内置的painterResource仅支持加载两类drawable资源：

1. VectorDrawable格式的XML矢量图
2. PNG、JPG、WebP这类静态栅格图片

你传入的占位图R.drawable.loading_animation不属于上述支持范围——大概率是GIF动图、AnimatedVectorDrawable动画矢量图、animation-list实现的帧动画这类动态资源，painterResource无法解析这类资源，直接抛出参数非法异常导致崩溃。

排查解决步骤 #

• 第一步：验证占位图问题
  先把占位图替换为普通静态资源（普通PNG加载图、静态VectorDrawable XML），如果替换后程序不再崩溃，即可确认问题根源是占位图格式不兼容。

  // 替换为静态资源做验证
  placeholder = painterResource(R.drawable.static_loading_icon)
  

• 第二步：按需选择适配方案
  • 如果不需要动画占位效果：直接保留静态占位图即可，同时删除代码中冗余的.size(Size.ORIGINAL)配置——Coil会自动根据组件尺寸加载对应分辨率的图片，强制指定原始尺寸会增加内存占用，提升OOM风险。
  • 如果需要保留GIF/动画占位效果：
    1. 先添加Coil对应格式的解码依赖，版本和你当前使用的coil-compose:2.1.0保持一致：

       // 模块级build.gradle dependencies块中添加
       implementation "io.coil-kt:coil-gif:2.1.0"
       

    2. 不要用painterResource加载动画占位图，将占位图配置交给ImageRequest处理，同时注册对应解码器：

       @Composable
       fun AstroPhoto(picture: AstroPicture) {
           val context = LocalContext.current
           val imgUrl = picture.url.toUri()
               .buildUpon()
               .scheme("https")
               .build()
           // 配置支持GIF解码的ImageLoader
           val gifImageLoader = remember(context) {
               ImageLoader.Builder(context)
                   .components {
                       if (Build.VERSION.SDK_INT >= 28) {
                           add(AnimatedImageDecoder.Factory())
                       } else {
                           add(GifDecoder.Factory())
                       }
                   }
                   .build()
           }
       
           AsyncImage(
               model = ImageRequest.Builder(context)
                   .data(imgUrl)
                   .crossfade(true)
                   .placeholder(R.drawable.loading_animation) // Coil自行加载占位图
                   .build(),
               imageLoader = gifImageLoader,
               contentDescription = picture.title,
               contentScale = ContentScale.Crop,
           )
       }
       

• 第三步：列表性能优化
  你在LazyColumn中使用图片组件时，建议给列表项添加唯一key，避免滑动时重复触发图片加载，提升列表流畅度：

  LazyColumn {
      items(
          items = state.astroPictures,
          key = { photo -> photo.url /* 用数据的唯一字段作为key */ }
      ) { photo ->
          AstroPhoto(picture = photo)
      }
  }
  

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