Flutter 外部存储读取 JSON 权限被拒绝？解决方法全攻略

如何在 Flutter 中从外部存储读取 JSON 文件时避免权限被拒绝错误

引言

在 Flutter 中开发应用程序时，访问和操作外部存储是一个常见需求。然而，当尝试从外部共享文件夹读取 JSON 文件时，可能会遇到权限被拒绝的错误。这可能是由于各种原因造成的，包括权限未正确配置或文件不存在。本指南将深入探讨此问题，并提供逐步解决此错误的综合方法。

问题

当尝试使用 dart:io 包从外部共享文件夹（如 /storage/emulated/0/Documents）加载 JSON 文件时，可能会引发以下错误：

PathAccessException: Cannot open file, path = '/storage/emulated/0/Documents/myfile.json' (OS Error: Permission denied, errno = 13)

解决方法

1. 检查存储权限

确保已在 AndroidManifest.xml 中声明 READ_EXTERNAL_STORAGE 和 WRITE_EXTERNAL_STORAGE 权限。还可以通过调用 await Permission.storage.status 来检查应用程序的权限状态。如果权限被拒绝，请使用 await Permission.storage.request() 请求权限。

2. 使用 getExternalStoragePublicDirectory

尝试使用 getExternalStoragePublicDirectory 方法代替硬编码路径来获取外部共享文件夹的路径。该方法将返回存储在公共文件夹中的文件的路径。

3. 验证文件是否存在

在尝试加载文件之前，请使用 File.exists 方法检查文件是否存在。如果文件不存在，则会收到错误消息。

4. 使用 openRead

使用 openRead 方法以只读模式打开文件。这将返回一个 RandomAccessFile 对象，可用于读取文件。

示例代码

以下示例代码演示了如何在 Flutter 中正确从外部存储读取 JSON 文件：

import 'dart:convert';
import 'dart:io';

import 'package:permission_handler/permission_handler.dart';

Future<void> loadConfig() async {
  // 检查存储权限
  var status = await Permission.storage.status;
  if (status != PermissionStatus.granted) {
    await Permission.storage.request();
  }

  // 获取外部共享文件夹的路径
  Directory externalDocumentsDirectory = await getExternalStoragePublicDirectory(Directory.documents);

  // 检查文件是否存在
  File jsonFile = File('${externalDocumentsDirectory.path}/myfile.json');
  if (await jsonFile.exists()) {
    // 使用 openRead 以只读模式打开文件
    var jsonData = json.decode(jsonFile.readAsStringSync());

    print('Loaded JSON data: $jsonData');
  } else {
    print('File not found');
  }
}

结论

通过遵循这些步骤，开发人员应该能够在 Flutter 中从外部共享文件夹读取 JSON 文件，而不会遇到权限被拒绝错误。确保正确配置权限、使用 getExternalStoragePublicDirectory 获取路径、验证文件是否存在并使用 openRead 打开文件非常重要。

常见问题解答

1. 为什么我仍然在加载文件时收到权限被拒绝错误？

   确保已授予应用程序所有必要的权限，包括 READ_EXTERNAL_STORAGE 和 WRITE_EXTERNAL_STORAGE。还应检查 Permission.storage.status 以确认已授予权限。

2. 为什么使用 getExternalStoragePublicDirectory 而不是硬编码路径？

   getExternalStoragePublicDirectory 将返回存储在公共文件夹中的文件的路径，确保应用程序可以访问这些文件。

3. 如何检查文件是否存在？

   可以使用 File.exists 方法检查文件是否存在。如果文件不存在，则会收到错误消息。

4. 我可以使用哪些其他方法打开文件进行只读操作？

   除了 openRead 之外，还可以使用 readAsString 和 readAsBytes 方法打开文件进行只读操作。

5. 如何处理加载文件时发生的异常？

   可以使用 try-catch 语句来捕获加载文件时发生的异常。这将允许您记录错误并采取适当的操作。