CameraX捕获Bitmap无法压缩分享至WhatsApp，遇TransactionTooLargeException

问题背景 #

我通过CameraX API成功捕获图像后，用以下方法将Image转换为Bitmap，可以正常显示在ImageView中：

fun Image.toBitmap(): Bitmap {
    val buffer = planes[0].buffer
    buffer.rewind()
    val bytes = ByteArray(buffer.capacity())
    buffer.get(bytes)
    return BitmapFactory.decodeByteArray(bytes, 0, bytes.size)
}

但尝试不保存到外部存储就分享到WhatsApp时，使用压缩方法出现了android.os.TransactionTooLargeException: data parcel size 51917416 bytes错误，压缩代码如下：

private fun btmToPng(){
    try {
        val baos = ByteArrayOutputStream()
        bitmap.compress(Bitmap.CompressFormat.JPEG, 40, baos)
        baos.close()
    } catch (e: java.lang.Exception) {
        e.printStackTrace()
    }
}

问题原因 #

这个异常是因为跨进程传递的数据超过了Binder的限制（通常约1MB）。CameraX捕获的原始图像分辨率极高（比如48MP），即使压缩质量，生成的字节数组大小仍可能远超阈值；直接将Bitmap或字节数组放入Intent Extra传递时，会触发跨进程序列化，导致报错。

解决步骤 #

1. 先缩小Bitmap尺寸（核心优化） #

仅压缩质量不足以大幅降低数据体积，先将Bitmap缩小到合理尺寸（比如1080p以内），再进行质量压缩：

fun resizeBitmap(bitmap: Bitmap, maxWidth: Int, maxHeight: Int): Bitmap {
    val width = bitmap.width
    val height = bitmap.height
    val scaleFactor = min(maxWidth.toFloat() / width, maxHeight.toFloat() / height)
    
    // 如果Bitmap已经小于目标尺寸，直接返回
    if (scaleFactor >= 1f) return bitmap

    val matrix = Matrix()
    matrix.postScale(scaleFactor, scaleFactor)
    return Bitmap.createBitmap(bitmap, 0, 0, width, height, matrix, true)
}

2. 使用FileProvider生成临时Uri分享 #

不要直接传递Bitmap或字节数组，而是将压缩后的图片保存到内部存储的临时文件，通过FileProvider生成Uri供WhatsApp读取，避免跨进程传递大数据：

步骤2.1 注册FileProvider

在AndroidManifest.xml中添加FileProvider配置：

<provider
    android:name="androidx.core.content.FileProvider"
    android:authorities="${applicationId}.fileprovider"
    android:exported="false"
    android:grantUriPermissions="true">
    <meta-data
        android:name="android.support.FILE_PROVIDER_PATHS"
        android:resource="@xml/file_paths" />
</provider>

步骤2.2 配置文件路径

在res/xml目录下创建file_paths.xml，指定临时文件的存储路径：

<?xml version="1.0" encoding="utf-8"?>
<paths>
    <files-path name="temp_images" path="temp/" />
</paths>

步骤2.3 完整分享代码

private fun shareBitmapToWhatsApp(originalBitmap: Bitmap) {
    // 1. 缩小Bitmap到1080p以内
    val resizedBitmap = resizeBitmap(originalBitmap, 1920, 1080)
    
    // 2. 创建内部存储的临时文件
    val tempDir = File(filesDir, "temp")
    tempDir.mkdirs()
    val tempFile = File(tempDir, "${System.currentTimeMillis()}.jpg")

    try {
        // 3. 压缩并写入临时文件
        val fos = FileOutputStream(tempFile)
        resizedBitmap.compress(Bitmap.CompressFormat.JPEG, 70, fos)
        fos.flush()
        fos.close()

        // 4. 生成可分享的Uri
        val shareUri = FileProvider.getUriForFile(
            this,
            "${packageName}.fileprovider",
            tempFile
        )

        // 5. 构建分享Intent
        val shareIntent = Intent(Intent.ACTION_SEND).apply {
            type = "image/jpeg"
            putExtra(Intent.EXTRA_STREAM, shareUri)
            // 授予WhatsApp读取Uri的权限
            addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION)
            // 直接指定WhatsApp包名，跳过选择器（可选）
            setPackage("com.whatsapp")
        }

        startActivity(Intent.createChooser(shareIntent, "分享图片到WhatsApp"))

    } catch (e: Exception) {
        e.printStackTrace()
    } finally {
        // 释放缩小后的Bitmap资源（如果和原Bitmap不是同一个对象）
        if (resizedBitmap !== originalBitmap) {
            resizedBitmap.recycle()
        }
        // 可选：在合适时机删除临时文件，比如onDestroy()
        // tempFile.delete()
    }
}

关键注意点 #

• 不要将Bitmap或大字节数组放入Intent.putExtra()，跨进程传递时会触发序列化，超过Binder限制就会报错。
• 临时文件存储在内部存储，只有你的App能访问，通过FileProvider授权给WhatsApp读取，无需申请外部存储权限。
• 分享完成后记得删除临时文件，避免占用设备存储。

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