Flutter使用Image.file加载外部存储图片遇PathNotFoundException求助

问题核心原因 #

你代码里的路径/source/emulated/0/Nathanael/solo/01.jpg存在错误，安卓外部存储的根路径应为/storage/emulated/0/，且硬编码路径易因设备差异出现兼容问题，这是触发PathNotFoundException的主要原因。

解决步骤 #

1. 用标准API获取存储路径，避免硬编码 #

推荐使用path_provider包获取安卓外部存储目录，确保路径兼容性：

• 先在pubspec.yaml添加依赖：

  dependencies:
    path_provider: ^2.1.1
  

• 通过API获取路径并拼接图片地址：

  import 'package:path_provider/path_provider.dart';
  import 'dart:io';
  
  Future<File> getTargetImage() async {
    final externalStorageDir = await getExternalStorageDirectory();
    // 拼接你的图片相对路径
    return File('${externalStorageDir!.path}/Nathanael/solo/01.jpg');
  }
  

2. 加载前检查文件是否存在 #

在渲染图片前先确认文件实际存在，避免抛出异常：

FutureBuilder<File>(
  future: getTargetImage(),
  builder: (context, snapshot) {
    if (snapshot.hasData && snapshot.data!.existsSync()) {
      return Container(child: Image.file(snapshot.data!));
    } else if (snapshot.hasError) {
      return Text('加载失败: ${snapshot.error}');
    }
    return CircularProgressIndicator();
  },
)

3. 确认权限配置无误 #

即使你已获取权限，仍需核对配置：

• 安卓Manifest文件中添加对应权限：
  • 安卓12及以下：

    <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"/>
    

  • 安卓13及以上：

    <uses-permission android:name="android.permission.READ_MEDIA_IMAGES"/>
    

• 确保已通过代码完成运行时动态权限请求，可配合permission_handler包实现。

4. 验证文件实际位置 #

通过设备文件管理器确认图片是否确实在/storage/emulated/0/Nathanael/solo/01.jpg路径下，排查文件名大小写、路径拼写错误等问题。

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