Flutter中image_picker的pickVideo返回null问题求助

针对你遇到的pickVideo调用后返回null的情况，按以下步骤排查修复：

1. 补全必要权限 #

录制视频除相机权限外，还需要录音权限（视频包含音频轨道）和存储权限（用于保存录制的视频文件）。在AndroidManifest.xml中补充以下权限：

<!-- 基础相机权限 -->
<uses-permission android:name="android.permission.CAMERA" />
<!-- 录音权限（录制视频必须） -->
<uses-permission android:name="android.permission.RECORD_AUDIO" />
<!-- Android 12及以下存储写入权限 -->
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<!-- Android 13+ 媒体视频读取权限 -->
<uses-permission android:name="android.permission.READ_MEDIA_VIDEO" />

2. 动态申请权限 #

Android 6.0+ 要求危险权限需动态申请，仅在Manifest中声明无效。可以使用permission_handler插件完成权限申请：

import 'package:permission_handler/permission_handler.dart';

// 批量申请所需权限
Future<bool> requestRequiredPermissions() async {
  final cameraPerm = await Permission.camera.request();
  final micPerm = await Permission.microphone.request();
  final storagePerm = await Permission.storage.request();

  return cameraPerm.isGranted && micPerm.isGranted && storagePerm.isGranted;
}

// 调用pickVideo前先校验权限
if (await requestRequiredPermissions()) {
  final video = await picker.pickVideo(source: ImageSource.camera);
  // 处理非空的video对象
} else {
  // 提示用户开启必要权限
}

3. 配置File Provider #

image_picker依赖File Provider访问录制的视频文件，在AndroidManifest.xml的<application>标签内添加配置：

<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>

然后在android/app/src/main/res/xml目录下创建file_paths.xml（无xml目录则新建），内容为：

<?xml version="1.0" encoding="utf-8"?>
<paths xmlns:android="http://schemas.android.com/apk/res/android">
    <external-files-path name="app_videos" path="Movies" />
</paths>

4. 排查设备环境问题 #

• 若使用模拟器，确保模拟器已配置可用的虚拟相机：部分模拟器默认未启用相机或相机配置异常，会导致录制失败返回null，建议切换到带相机的模拟器或直接用真机测试。
• 真机测试时，检查系统设置中是否禁止了应用的相机、录音权限。

5. 异常捕获与参数检查 #

用try-catch包裹pickVideo调用，捕获潜在异常并排查错误；同时避免设置过短的maxDuration参数：

try {
  final video = await picker.pickVideo(
    source: ImageSource.camera,
    maxDuration: const Duration(minutes: 3), // 合理设置最大录制时长
  );
  if (video == null) {
    print("用户取消了录制操作");
  } else {
    // 处理视频文件
  }
} catch (e) {
  print("录制过程出错: $e");
}

6. 升级插件版本 #

你使用的image_picker: ^0.8.6+1版本较旧，可能与Flutter 3.10.6存在兼容问题。建议升级到适配Flutter 3.x的最新稳定版（如image_picker: ^1.0.4），更新后执行flutter pub get和flutter clean清理缓存。

内容的提问来源于stack exchange，提问作者Love Joy Jose