Flutter path_provider无法获取SD卡路径，如何解决？

1. 核心原因分析 #

Android 10（API 29）及以上引入分区存储机制，默认限制第三方应用直接访问SD卡根目录；path_provider的getExternalStorageDirectories()仅会返回内部模拟存储路径（/storage/emulated/0/），无法直接获取SD卡的/storage/xxx-xxx/路径，需要通过权限配置+原生代码适配实现。

2. 配置Android权限 #

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

<!-- Android 10及以下读写外部存储权限 -->
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<!-- Android 11+ 访问所有文件的特殊权限 -->
<uses-permission android:name="android.permission.MANAGE_EXTERNAL_STORAGE"
    android:minSdkVersion="30" />

注意：MANAGE_EXTERNAL_STORAGE属于系统特殊权限，无法通过常规弹窗请求，需要引导用户到系统设置手动开启。

3. 动态请求基础权限 #

使用permission_handler包处理权限请求，先在pubspec.yaml添加依赖：

dependencies:
  permission_handler: ^10.2.0

然后编写权限请求代码：

import 'package:permission_handler/permission_handler.dart';

Future<void> requestStoragePermissions() async {
  // 请求基础存储权限
  if (await Permission.storage.isDenied) {
    await Permission.storage.request();
  }
  // Android 11+ 请求全文件访问权限
  if (await Permission.manageExternalStorage.isDenied) {
    await Permission.manageExternalStorage.request();
  }
}

4. 通过平台通道获取SD卡路径 #

由于Flutter原生包无法直接获取SD卡根路径，需要通过MethodChannel调用Android原生代码实现：

步骤1：Flutter端定义通道 #

import 'package:flutter/services.dart';

class SdCardHelper {
  static const MethodChannel _channel = MethodChannel('sd_card_path_channel');

  // 获取所有SD卡根路径
  static Future<List<String>?> getSdCardRootPaths() async {
    try {
      final List<dynamic>? rawPaths = await _channel.invokeMethod('getSdCardPaths');
      return rawPaths?.cast<String>();
    } on PlatformException catch (e) {
      print("获取SD卡路径失败: ${e.message}");
      return null;
    }
  }
}

步骤2：Android原生端实现路径获取 #

在android/app/src/main/kotlin/[你的包名]/MainActivity.kt中添加通道处理逻辑：

import android.os.Environment
import io.flutter.embedding.android.FlutterActivity
import io.flutter.embedding.engine.FlutterEngine
import io.flutter.plugin.common.MethodChannel

class MainActivity : FlutterActivity() {
    private val CHANNEL = "sd_card_path_channel"

    override fun configureFlutterEngine(flutterEngine: FlutterEngine) {
        super.configureFlutterEngine(flutterEngine)
        MethodChannel(flutterEngine.dartExecutor.binaryMessenger, CHANNEL).setMethodCallHandler { call, result ->
            if (call.method == "getSdCardPaths") {
                val sdPaths = getValidSdCardPaths()
                result.success(sdPaths)
            } else {
                result.notImplemented()
            }
        }
    }

    private fun getValidSdCardPaths(): List<String> {
        val paths = mutableListOf<String>()
        // 获取所有外部存储目录（包含SD卡）
        val externalDirs = getExternalFilesDirs(null)
        externalDirs.forEach { dir ->
            dir?.let {
                val fullPath = it.absolutePath
                // 过滤内部模拟存储，截取SD卡根目录
                if (!fullPath.contains("emulated")) {
                    val rootPath = fullPath.split("/Android/data/")[0]
                    paths.add(rootPath)
                }
            }
        }
        return paths
    }
}

5. 额外注意事项 #

• Android 10+ 推荐使用**存储访问框架（SAF）**操作SD卡文件，避免分区存储限制带来的访问异常；
• 若用户未开启MANAGE_EXTERNAL_STORAGE权限，可引导其跳转到应用设置页：

import 'package:permission_handler/permission_handler.dart';

Future<void> navigateToAppSettings() async {
  await openAppSettings();
}

• 部分设备存在多个存储分区，需处理多路径返回的情况。

内容的提问来源于stack exchange，提问作者Eric Larrivé