Flutter使用Image_Picker选图后不显示且报multiple_request异常怎么解决?
问题根因
- API版本不兼容:你当前使用的
getImage方法是image_picker 0.8.x之前的废弃API,新版本中该方法的调用逻辑存在并发缺陷,容易触发多次请求冲突报错 - 无防重复请求校验:点击相册按钮后未做请求状态锁定,若用户快速点击多次、或者系统回调延迟导致多次触发选图逻辑,就会抛出
multiple_request异常,终止后续图片渲染逻辑 - 权限配置缺失:安卓需要读写存储权限、iOS需要相册访问权限,未配置的话也会导致选图后返回null,无法正常渲染图片
解决方案
步骤1:替换废弃API并添加防重复请求锁
修改状态类代码,新增选图状态锁,将废弃的getImage替换为新版pickImage,修改后的代码如下:
class _PageDescriptionState extends State<PageDescription> { ImagePicker _imageFile = ImagePicker(); File? _image; bool _isPicking = false; // 新增选图状态锁 Future getImage(ImageSource source) async { if (_isPicking) return; // 已有选图请求在处理,直接拦截 _isPicking = true; try { // 替换废弃的getImage为新版pickImage final XFile? pickFile = await _imageFile.pickImage(source: source); setState(() { if (pickFile != null) { _image = File(pickFile.path); } else { print("Pas d'image selectionnée"); } }); } catch (e) { print("选图异常:$e"); } finally { _isPicking = false; // 无论成功失败都释放锁 } } // 剩余build方法无需修改 }
步骤2:配置对应平台权限
- 安卓端:在
android/app/src/main/AndroidManifest.xml的<manifest>标签下添加权限:
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" /> <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" /> <!-- 安卓13及以上版本需要添加以下权限 --> <uses-permission android:name="android.permission.READ_MEDIA_IMAGES" />
- iOS端:在
ios/Runner/Info.plist的<dict>标签下添加权限说明:
<key>NSPhotoLibraryUsageDescription</key> <string>需要访问您的相册上传图片</string>
步骤3:升级依赖版本
在pubspec.yaml中将image_picker升级到最新稳定版:
dependencies: image_picker: ^1.0.4
修改完成后执行flutter clean再重新编译运行即可。
内容的提问来源于stack exchange,提问作者pierrot0630
相关产品推荐
相关产品推荐

