Flutter下载保存至外部存储的图片无法在系统相册显示问题咨询

你遇到的图片无法在系统相册查看的问题，由以下3个核心原因导致，对应解决方案如下：

1. 下载路径配置错误 #

你当前调用Dio().download()时传入的保存路径是Gallery Images文件夹路径，未指定完整的文件名（包含.jpg/.png等后缀），会导致文件保存失败或生成无后缀的无效文件，无法被相册识别。
修复方案：下载时拼接完整的文件名，示例如下：

// 从下载链接中提取文件名，也可自定义文件名（如时间戳+后缀）
String fileName = url.split('/').last;
// 完整保存路径 = 文件夹路径 + 文件名
String savePath = "$rootPath/Gallery/Gallery Images/$fileName";
await Dio().download(url, savePath, onReceiveProgress: (int sent, int total) {
  final progress = (sent / total) * 100;
  print('image download progress: $progress');
});

2. 存储路径不符合系统权限规则 #

你当前创建的Gallery目录处于Android系统目录下，属于应用私有存储范畴。Android 10及以上版本引入分区存储限制后，系统相册无权限访问第三方应用私有目录下的文件。
修复方案：将图片存储到系统公共媒体目录（DCIM/Pictures），示例如下：

// 获取系统公共图片目录，不需要申请manageExternalStorage高危权限
String? publicDir = (await p.getExternalStoragePublicDirectory(p.DirectoryType.pictures))?.path;
final path = Directory("$publicDir/Gallery/Gallery Images");
// 后续文件夹创建、下载逻辑不变

额外优化提示：如果使用系统公共媒体目录存储，不需要申请manageExternalStorage高危权限，仅需要对应版本的存储权限即可：Android 12及以下申请storage权限，Android 13及以上申请READ_MEDIA_IMAGES权限即可，可降低应用上架的权限审核风险。

3. 未主动通知系统媒体库刷新 #

安卓系统不会主动扫描所有目录的新增文件，图片保存完成后，需要主动触发系统媒体库扫描该文件，将其加入相册索引。
修复方案：可使用media_scanner插件完成扫描，执行以下操作：
首先在pubspec.yaml中添加依赖：

dependencies:
  media_scanner: ^2.1.0

下载完成后调用扫描逻辑：

// 下载完成后调用
await MediaScanner.loadMedia(path: savePath);

如果不想引入第三方插件，也可以通过原生MethodChannel发送ACTION_MEDIA_SCANNER_SCAN_FILE广播实现扫描。

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