Flutter中如何获取用户相册的实际路径？

一、临时路径重启后无法加载的解决方案 #

ImagePicker返回的临时文件会在应用重启、系统清理缓存时被自动删除，必须将选中的图片复制到应用的持久化存储目录，再保存这个持久化路径用于后续加载。

实现步骤与代码示例 #

import 'dart:io';
import 'package:path_provider/path_provider.dart';
import 'package:image_picker/image_picker.dart';
import 'package:shared_preferences/shared_preferences.dart';

// 将临时图片复制到应用文档目录（持久化存储）
Future<String> saveImageToPersistentDir(XFile tempImage) async {
  final appDocDir = await getApplicationDocumentsDirectory();
  final targetPath = '${appDocDir.path}/${tempImage.name}';
  await File(tempImage.path).copy(targetPath);
  return targetPath;
}

// 选择图片并保存持久化路径
void pickAndPersistImage() async {
  final picker = ImagePicker();
  final XFile? pickedImage = await picker.pickImage(source: ImageSource.gallery);
  
  if (pickedImage != null) {
    final persistentPath = await saveImageToPersistentDir(pickedImage);
    // 将持久化路径保存到SharedPreferences，供下次启动使用
    final prefs = await SharedPreferences.getInstance();
    await prefs.setString('saved_image_path', persistentPath);
  }
}

// 下次启动加载图片
void loadSavedImage() async {
  final prefs = await SharedPreferences.getInstance();
  final savedPath = prefs.getString('saved_image_path');
  if (savedPath != null && File(savedPath).existsSync()) {
    // 使用savedPath加载图片，比如Image.file(File(savedPath))
  }
}

关键说明 #

• getApplicationDocumentsDirectory()获取的目录是应用专属存储区，仅当前应用可访问，卸载应用时才会被删除，不会被系统随意清理
• 持久化路径建议存在SharedPreferences、Hive或本地数据库中，避免丢失

二、删除系统相册照片的解决方案 #

ImagePicker仅提供图片选择能力，无法直接删除系统相册照片，需要借助权限申请和专门的媒体管理插件实现。

1. 配置权限 #

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

<uses-permission android:name="android.permission.READ_MEDIA_IMAGES" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" android:maxSdkVersion="32" />
<uses-permission android:name="android.permission.DELETE_PHOTOS" />

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

<key>NSPhotoLibraryUsageDescription</key>
<string>需要访问相册以管理照片</string>
<key>NSPhotoLibraryAddUsageDescription</key>
<string>需要访问相册以管理照片</string>

2. 使用photo_manager插件实现删除 #

import 'package:photo_manager/photo_manager.dart';

Future<void> deleteAlbumPhoto(String targetFileName) async {
  // 申请相册权限
  final permissionState = await PhotoManager.requestPermissionExtend();
  if (!permissionState.isAuth) return;

  // 查询所有图片资源
  final imageAssets = await PhotoManager.getAssetListWithType(
    type: RequestType.image,
  );

  // 匹配目标图片（可根据文件名、路径或ID匹配）
  final targetAsset = imageAssets.firstWhere(
    (asset) => asset.title == targetFileName,
    orElse: () => throw Exception('未找到目标图片'),
  );

  // 执行删除
  await PhotoManager.deleteWithIds([targetAsset.id]);
}

关键说明 #

• Android 13+需要DELETE_PHOTOS权限，低版本依赖WRITE_EXTERNAL_STORAGE
• iOS删除操作会触发系统弹窗，需用户确认后才能执行
• 敏感操作必须向用户明确说明用途，避免应用审核被拒

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