Android Compose中painterResource加载图片遇OutOfMemoryError的解决方法

问题说明 #

使用Compose的Image组件配合painterResource加载图片时，频繁触发java.lang.OutOfMemoryError导致App崩溃，核心原因是图片加载过程中内存占用过高。

崩溃日志示例 #

Fatal Exception: java.lang.OutOfMemoryError
Failed to allocate a 18195852 byte allocation with 10423024 free bytes and 9MB until OOM

dalvik.system.VMRuntime.newNonMovableArray (VMRuntime.java)
android.graphics.BitmapFactory.nativeDecodeAsset (BitmapFactory.java)
android.graphics.BitmapFactory.decodeStream (BitmapFactory.java:624)
...
androidx.compose.ui.res.PainterResources_androidKt.painterResource (PainterResources.android.kt:70)
com.ui.screens.main.MainScreenKt$VipLevels$$inlined$ConstraintLayout$5.invoke (ConstraintLayout.kt:2308)
...（完整栈信息见用户提供内容）

优化方案与最佳实践 #

1. 从图片资源本身优化 #

• 压缩尺寸：图片实际显示多大就制作多大，比如仅需显示100dp的图，就不要用4000×3000像素的原图，避免不必要的内存浪费。
• 更换格式：尽量使用WebP格式，相同画质下比JPG/PNG小25%-50%；透明图也支持WebP，替代PNG能大幅减少体积。
• 按密度分类资源：将对应密度的图片放到drawable-mdpi、drawable-hdpi等目录，避免系统自动缩放带来的额外内存开销。

2. 替换painterResource，使用智能加载库 #

painterResource会直接解码原图，不会根据显示尺寸自动优化，内存浪费严重，可替换为：

• Coil：Compose官方推荐的图片加载库，自动根据组件尺寸采样加载，自带内存、磁盘缓存，高效省内存。
  用法示例：

  // 先添加依赖：implementation("io.coil-kt:coil-compose:2.5.0")
  Image(
      painter = rememberAsyncImagePainter("drawable://${R.drawable.your_image}"),
      contentDescription = "图片描述",
      modifier = Modifier.size(100.dp)
  )
  

• Glide Compose扩展：适合已使用Glide的项目，同样支持根据目标尺寸优化加载。

3. 手动实现图片采样（无需第三方库） #

如果不想引入第三方库，可手动编写采样解码逻辑：

fun loadSampledBitmap(context: Context, resId: Int, targetWidth: Int, targetHeight: Int): ImageBitmap {
    val options = BitmapFactory.Options().apply {
        // 先获取图片尺寸，不加载到内存
        inJustDecodeBounds = true
        BitmapFactory.decodeResource(context.resources, resId, this)
        // 计算采样率，让图片尺寸接近目标大小
        inSampleSize = calculateSampleSize(this, targetWidth, targetHeight)
        inJustDecodeBounds = false
        // 无透明需求时用RGB_565，每个像素占2字节，比ARGB_8888省一半内存
        inPreferredConfig = Bitmap.Config.RGB_565
    }
    val bitmap = BitmapFactory.decodeResource(context.resources, resId, options)
    return bitmap.asImageBitmap()
}

private fun calculateSampleSize(options: BitmapFactory.Options, reqWidth: Int, reqHeight: Int): Int {
    val (imgHeight, imgWidth) = options.outHeight to options.outWidth
    var sampleSize = 1

    if (imgHeight > reqHeight || imgWidth > reqWidth) {
        val halfHeight = imgHeight / 2
        val halfWidth = imgWidth / 2

        // 找到最大的采样率，让缩放后的图片不小于目标尺寸
        while (halfHeight / sampleSize >= reqHeight && halfWidth / sampleSize >= reqWidth) {
            sampleSize *= 2
        }
    }
    return sampleSize
}

在Compose中使用：

val context = LocalContext.current
// 用remember缓存，避免每次重组都重新加载
val imageBitmap = remember {
    loadSampledBitmap(context, R.drawable.your_image, 200, 200) // 目标宽高（像素）
}
Image(bitmap = imageBitmap, contentDescription = "图片描述")

4. 避免重复加载与内存泄漏 #

• 用remember缓存painter或bitmap：避免每次重组都重新解码图片，一次加载后缓存复用。
• 及时回收资源：自行加载的Bitmap在不再使用时调用recycle()，第三方库通常会自动处理资源回收。

5. 临时方案：开启大内存（不推荐依赖） #

若前面的优化仍无法解决问题，可在AndroidManifest.xml中为App开启大内存，但这只是临时救急，不能替代本质优化：

<application
    android:largeHeap="true"
    ...>
</application>

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