Flutter应用debug模式相机正常 打包release APK后相机无法工作

问题原因 #

这个问题是Flutter调用相机的常见场景问题，debug和release表现不一致主要由以下几个原因导致：

• Android端权限配置缺失：debug模式下默认会使用android/app/src/debug/AndroidManifest.xml中的临时权限配置，你调试时也手动授予过权限，但release打包只会读取main目录下的Manifest配置，未声明权限就会调用失败
• R8混淆压缩误伤依赖：release打包默认开启代码混淆和资源压缩，如果没有配置image_picker相关的保留规则，库的核心类会被误删导致无法正常执行
• 异步逻辑顺序错误：你当前的代码未等待拍照异步逻辑执行完成就直接关闭了弹窗，release模式下异步调度效率更高，会出现弹窗先关闭、context失效后拍照逻辑才执行的情况，直接中断流程
• 高版本Android系统权限适配缺失：Android10+分区存储、Android13+媒体权限未适配的情况下，release模式会禁止读取拍摄生成的照片文件，表现为相机调用后无返回

解决方法 #

• 补全Android权限声明
  在android/app/src/main/AndroidManifest.xml的<manifest>标签内添加如下权限：

<!-- 相机权限 -->
<uses-permission android:name="android.permission.CAMERA" />
<!-- Android 12及以下存储权限 -->
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" android:maxSdkVersion="32" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" android:maxSdkVersion="32" />
<!-- Android 13+图片访问权限 -->
<uses-permission android:name="android.permission.READ_MEDIA_IMAGES" />

如果同时适配iOS，需要在ios/Runner/Info.plist中添加相机和相册访问的权限描述。

• 配置混淆保留规则
  在android/app/proguard-rules.pro文件中添加如下规则，避免image_picker相关类被混淆删除：

-keep class androidx.exifinterface.** { *; }
-keep class com.yalantis.ucrop.** { *; }
-keep class io.flutter.plugins.imagepicker.** { *; }

同时确认android/app/build.gradle中release构建配置已引入混淆规则文件：

android {
    buildTypes {
        release {
            minifyEnabled true
            shrinkResources true
            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
        }
    }
}

• 修正异步调用逻辑
  将弹窗关闭操作放到所有异步逻辑执行完成之后，避免context提前失效：

ListTile(
  leading: Icon(Icons.camera_alt),
  title: Text('Camera'),
  onTap: () async {
    if (state == AppState.free) {
      await _pickImageCam();
      await _cropImage();
    }
    if (mounted) Navigator.pop(context);
  },
),

• 主动申请权限+升级依赖
  建议使用permission_handler库在调用相机前主动申请相机权限，不要依赖image_picker的内部权限申请逻辑；同时将image_picker升级到官方最新稳定版，避免旧版本的适配bug。

• 定位具体问题
  如果以上操作都完成后仍然存在问题，可以连接设备运行release包，执行adb logcat命令查看系统日志，定位具体的崩溃报错点。

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