Flutter获取外置SD卡路径时遇空指针异常求助

问题描述 #

使用external_path包获取外置SD卡路径时，触发以下空指针异常：

java.lang.NullPointerException: Attempt to invoke virtual method 'java.lang.String java.io.File.getAbsolutePath()' on a null object reference

同时日志显示无法确保SD卡上的应用私有目录：

W/ContextImpl(15102): Failed to ensure /storage/9016-4EF8/Android/data/com.pinciat.external_path_example/files: android.os.ServiceSpecificException:  (code -22)

错误原因分析 #

1. 权限不足：Android 13及以上版本对外置存储的访问权限限制升级，仅READ_EXTERNAL_STORAGE/WRITE_EXTERNAL_STORAGE无法访问外置SD卡的应用私有目录，需要MANAGE_EXTERNAL_STORAGE权限；部分低版本设备也可能存在权限未正确申请的情况。
2. SD卡状态异常：外置SD卡未挂载、损坏，或者目标路径不存在，导致包内代码获取到的File对象为null。
3. external_path包自身bug：从错误栈可知，包的ExternalPathPlugin.kt第52行未对File对象做非空判断，直接调用getAbsolutePath()，触发空指针。

解决方案 #

1. 配置并申请正确的存储权限 #

在android/app/src/main/AndroidManifest.xml中添加权限声明：

<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" android:maxSdkVersion="32" />
<uses-permission android:name="android.permission.MANAGE_EXTERNAL_STORAGE" />

动态申请权限（需依赖permission_handler包）：

import 'package:permission_handler/permission_handler.dart';

Future<void> requestStoragePermissions() async {
  // Android 13+ 需要申请MANAGE_EXTERNAL_STORAGE
  if (await Permission.manageExternalStorage.isDenied) {
    await Permission.manageExternalStorage.request();
  }
  // Android 12及以下申请读写权限
  if (await Permission.storage.isDenied) {
    await Permission.storage.request();
  }
}

2. 检查SD卡状态 #

• 确认外置SD卡已正确插入并挂载，可通过设备系统设置查看SD卡状态。
• 测试其他应用能否正常访问SD卡，排除硬件或系统层面的问题。

3. 修复或替换external_path包 #

修复包源码

找到external_path包的ExternalPathPlugin.kt文件，在第52行附近添加非空判断：

// 原代码可能类似：
paths.add(file.absolutePath)
// 修改为：
if (file != null) {
    paths.add(file.absolutePath)
}

修改后可以将包作为本地依赖引入项目。

替换为其他包

改用path_provider结合相关外置存储插件，或者直接通过MethodChannel调用Android原生代码获取外置SD卡路径，避免依赖第三方包的bug。

4. 捕获异常避免崩溃 #

在调用ExternalPath.getExternalStorageDirectories()时添加异常捕获，同时提供降级方案：

import 'package:external_path/external_path.dart';
import 'package:path_provider/path_provider.dart';

Future<List<String>?> getSdCardPaths() async {
  try {
    return await ExternalPath.getExternalStorageDirectories();
  } catch (e) {
    print('获取SD卡路径失败：$e');
    // 降级使用内部存储路径
    final internalDir = await getExternalStorageDirectory();
    return internalDir != null ? [internalDir.path] : null;
  }
}

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