Flutter image_picker真机非调试模式无法访问相机如何解决

核心原因 #

Debug模式下Flutter开发环境会默认授予调试应用临时权限，不会触发严格的系统权限校验，但Release（非调试）模式会完全遵循原生平台的权限规则，这类问题90%以上都是原生端权限配置缺失导致，和贴出的Dart业务逻辑关联不大，另外现有Dart代码还存在两个稳定性隐患。

第一步：补全原生端权限配置（必做） #

Android端配置 #

1. 打开路径android/app/src/main/AndroidManifest.xml，在<manifest>根节点下、<application>标签之前，添加所需权限声明：

<!-- 相机基础权限 -->
<uses-permission android:name="android.permission.CAMERA" />
<!-- Android 13+ 读取媒体图片权限 -->
<uses-permission android:name="android.permission.READ_MEDIA_IMAGES" />
<!-- Android 12及以下读取存储权限，高版本自动失效 -->
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" android:maxSdkVersion="32" />

2. 如果打包开启了代码混淆，打开android/app/proguard-rules.pro，添加image_picker依赖的混淆白名单，避免Release下类被混淆导致插件失效：

-keep class com.luck.picture.lib.** { *; }
-keep class com.yalantis.ucrop.** { *; }

iOS端配置 #

打开路径ios/Runner/Info.plist，在<dict>节点内添加权限说明，系统在申请相机权限时会把这段文案展示给用户，缺失的话Release下会直接拦截权限请求：

<key>NSCameraUsageDescription</key>
<string>需要访问相机拍摄照片</string>
<key>NSPhotoLibraryUsageDescription</key>
<string>需要访问相册保存/读取照片</string>

第二步：修复Dart代码隐患 #

当前代码有两个容易触发异常的问题，修改后稳定性会明显提升：

• FloatingActionButton内部嵌套了IconButton，两个组件都绑定了拍照方法，点击时会重复触发两次拍照逻辑，直接在FloatingActionButton里放Icon组件即可
• 没有处理用户取消拍照、权限被拒的场景，直接对imageFile做强制解包（!）会在Release模式下直接触发崩溃

修改后的核心代码片段：

Future<void> _takePicture() async {
  final ImagePicker picker = ImagePicker();
  // 捕获权限拒绝、用户取消、设备异常等错误
  try {
    final XFile? imageFile = await picker.pickImage(
      source: ImageSource.camera,
      maxWidth: 600,
      imageQuality: 80, // 增加压缩参数，避免大图加载内存溢出
    );
    // 用户主动取消拍照时直接返回，不做后续处理
    if (imageFile == null) return;
    setState(() {
      _image = File(imageFile.path);
    });
  } catch (e) {
    debugPrint("拍照调用失败: $e");
    // 此处可增加弹窗提示，引导用户到系统设置页开启相机权限
  }
}

// 对应浮动按钮部分修改后代码
FloatingActionButton(
  backgroundColor: CupertinoColors.black,
  onPressed: _takePicture,
  child: const Icon(Icons.camera),
)

验证方法 #

配置完成后执行命令flutter run --release在真机上测试，该模式运行环境和正式发布的安装包完全一致，能正常调起相机即说明修复完成。

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