Flutter真机调试报INSTALL_FAILED_INSUFFICIENT_STORAGE错误解决方法

报错信息 #

Error: ADB exited with exit code 1
Performing Streamed Install

adb: failed to install S:\Work\egy_servy_client_app\build\app\outputs\flutter-apk\app.apk: 
Failure [INSTALL_FAILED_INSUFFICIENT_STORAGE]
Error launching application on PRA LA1.

核心原因 #

ADB向设备推送安装APK时，设备可用存储空间（含系统单独划分的安装临时分区）不足以支撑安装包拷贝、解压、写入的全流程，触发安装中断。

排查解决步骤 #

• 先清理设备存储：打开手机设置-存储页面查看剩余空间，至少预留出当前APK体积2倍以上的空闲空间（安装过程会产生临时文件，实际占用空间大于APK本身大小）。优先清理大体积应用缓存、删除长期不用的APP、把本地存储的大体积视频/照片转移到电脑，不要只看系统自带清理工具报的剩余数值，部分机型系统会给安装分区单独划空间，用户分区剩余足够也可能因为安装分区不足报错。
• 彻底卸载旧版本同包名应用：手动在桌面长按对应调试应用图标选择卸载，也可以执行ADB命令清理残留：

  # 替换为你自己的应用包名
  adb uninstall com.your.app.packagename
  # 强制清理同包名所有残留数据，包括多用户下的安装记录
  adb shell pm uninstall -k com.your.app.packagename
  

  卸载完成后重启一次手机再尝试安装。
• 针对使用的PRA LA1（荣耀8青春版）机型做专项排查：
  • 检查是否开启了隐私空间、多用户功能，其他用户/隐私空间下如果残留了同应用的旧安装包，会占用系统安装分区空间，切换到对应用户卸载旧应用，或者直接删除多余的用户/隐私空间即可。
  • 打开开发者选项，确认「USB安装」「USB调试（安全设置）」权限已经开启，部分华为系机型权限未开时会误报存储不足错误。
• 重启ADB服务排除连接异常：依次执行以下命令后重新运行flutter run

  adb kill-server
  adb start-server
  

• 调试阶段减小APK体积：构建调试包时添加--split-per-abi参数，仅构建当前设备CPU架构对应的APK，包体积通常能降到通用包的1/3到1/2，大幅降低安装时的空间要求：

  flutter run --split-per-abi
  

• 以上操作都无效时，可以重启手机到Recovery模式，选择清除缓存分区（Wipe Cache Partition），该操作不会删除个人数据，只会清理系统全局缓存文件，清理完成后重启手机即可正常安装。

注意：不要在存储空间刚够APK大小的时候尝试安装，Android系统安装应用时默认需要预留至少1GB的临时缓冲空间，剩余空间不足1GB时大概率会触发该报错。

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