Flutter ImagePicker从相册选择图片始终返回null问题求助

问题描述 #

使用ImagePicker库从手机相册选择图片时，返回结果始终为null，但调用相机拍照功能正常。尝试过File/PickedFile两种数据类型，更换过image_picker版本（当前使用0.6.7+22），问题依旧存在。

可能原因及解决步骤 #

1. 检查平台权限配置 #

权限缺失是相册选图返回null的常见原因，需针对Android和iOS分别配置：

• Android：在android/app/src/main/AndroidManifest.xml中添加权限

  <!-- Android 12及以下 -->
  <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
  <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
  <!-- Android 13及以上 -->
  <uses-permission android:name="android.permission.READ_MEDIA_IMAGES" />
  

• iOS：在ios/Runner/Info.plist中添加权限描述

  <key>NSPhotoLibraryUsageDescription</key>
  <string>需要访问您的相册以选择图片</string>
  

2. 修正代码调用逻辑 #

• 避免在build方法内部定义异步方法（build会频繁重建，易导致上下文异常），将cameraImage、galleryImage移至build外部
• 添加null判断，防止空指针异常

3. 版本适配与缓存清理 #

• 尝试升级到image_picker稳定版（如0.8.6+3）
• 执行以下操作清理缓存并重装应用：

  flutter clean
  rm pubspec.lock
  flutter pub get
  

修正后的完整代码示例 #

import 'dart:io';
import 'package:image_picker/image_picker.dart';
import 'package:flutter/material.dart';
import 'package:cached_network_image/cached_network_image.dart';

class SaveImage extends StatefulWidget {
  @override
  _SaveImageState createState() => _SaveImageState();
}

class _SaveImageState extends State<SaveImage> {
  File _img;
  final String img_url = "your_image_url_here";
  final GlobalKey<ScaffoldState> globalKey = GlobalKey<ScaffoldState>();

  Future cameraImage() async {
    // 使用最新API替代已废弃的pickImage
    final XFile? img = await ImagePicker().pickImage(source: ImageSource.camera);
    if (img != null) {
      setState(() {
        _img = File(img.path);
      });
    }
  }

  Future galleryImage() async {
    final XFile? img = await ImagePicker().pickImage(source: ImageSource.gallery);
    print("data: ${img}");
    if (img != null) {
      setState(() {
        _img = File(img.path);
      });
    } else {
      print("用户取消选择或未获取到图片");
    }
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      key: globalKey,
      backgroundColor: Colors.purple[100],
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: [
            // 显示选中图片或默认网络图
            _img != null
                ? Image.file(_img, width: 80, height: 80)
                : CachedNetworkImage(
                    imageUrl: img_url,
                    width: 80,
                    height: 80,
                  ),
            SizedBox(height: 20),
            Row(
              mainAxisAlignment: MainAxisAlignment.center,
              children: [
                ElevatedButton(
                  onPressed: cameraImage,
                  child: Text("拍照"),
                ),
                SizedBox(width: 10),
                ElevatedButton(
                  onPressed: galleryImage,
                  child: Text("从相册选择"),
                ),
              ],
            ),
          ],
        ),
      ),
    );
  }
}

内容的提问来源于stack exchange，提问作者Wong Tao Zhe