Android端Capacitor相机插件选取10MB以上图片触发内存溢出报错
问题触发根因
你遇到的选大图冻屏、抛出Out of memory是@capacitor/camera v3版本的共性问题,核心触发逻辑两点:
- 当前配置组合为
quality:100+ 无尺寸上限 +resultType: Base64,v3版本对Base64返回模式没有做默认的尺寸压缩兜底,插件原生层不会对选中的相册原图做任何缩放处理,直接将全尺寸位图解码到内存,再转成比原文件大33%的Base64字符串存到JS堆中 - 全尺寸位图的解码过程在原生主线程执行,超过10MB的原图解码时间长达数秒,直接阻塞WebView的JS线程造成应用冻屏,当内存占用超过WebView分配的上限时,就会抛出内存溢出异常
可落地的修复方案
1. 优先调整插件核心配置,从根源降低内存占用
这是见效最快的方案,不需要改动其他业务逻辑,具体调整点:
- 把
quality参数从100降到80-90区间,日常业务场景下这个质量的图片视觉差异几乎不可感知,插件会自动在解码后做对应比例的压缩 - 新增
width、height参数设置最大尺寸上限(常规场景设为1920px宽即可),插件原生层会自动将超过阈值的图片等比例缩放,从根源减少解码后的位图内存——按移动端位图内存计算规则,单张图片解码后的内存占用为「宽高4字节」,4000px宽的原图解码后内存占用可达48MB,缩到1920px宽后仅为11MB,内存占用减少75%以上 - 非强依赖不要使用
CameraResultType.Base64返回模式,优先替换为CameraResultType.Uri,拿到本地临时文件路径后按需读取内容,避免全图Base64字符串长期占用JS内存
修正后的配置与代码示例:
let camOption: CameraOptions = { quality: 85, width: 1920, height: 1080, resultType: CameraResultType.Uri, source: CameraSource.Photos, saveToGallery: false } try { const result = await Camera.getPhoto(camOption); // 如果需要上传文件,直接用fetch读取Uri对应的Blob即可,无需转Base64字符串 const imageRes = await fetch(result.webPath!); const imageBlob = await imageRes.blob(); // 直接将Blob传给接口的FormData即可完成上传,内存占用远低于Base64方案 } catch (error) { console.log(JSON.stringify(error)); }
2. 必须使用Base64返回场景的兼容调整
如果业务逻辑强依赖插件直接返回Base64字符串,需要做两处调整规避OOM:
- 严格限制图片最大边长不超过1280px,质量参数降到80以下
- 图片数据处理完成后,及时将对应的结果变量引用置空,触发JS垃圾回收释放内存,避免连续选图场景下的内存累加
3. 平台侧兜底配置
- Android端在
AndroidManifest.xml的Application节点添加android:largeHeap="true",给应用分配更大的堆内存上限,缓解大图处理时的内存压力 - 所有图片像素处理逻辑(比如canvas裁剪、压缩)放到Web Worker中执行,避免在主线程跑大图解码/绘制逻辑,消除选图时的冻屏问题
内容的提问来源于stack exchange,提问作者Tapas Mukherjee
相关产品推荐
相关产品推荐

