Flutter应用文件权限与文件处理异常问题求助

1. 解决read_external_storage_denied权限异常 #

原因分析 #

• Android 13（API 33）及以上版本已废弃READ_EXTERNAL_STORAGE和WRITE_EXTERNAL_STORAGE权限，拆分细分为媒体文件权限（如READ_MEDIA_IMAGES、READ_MEDIA_AUDIO等）；
• 新版file_picker依赖无需手动申请存储权限，它通过系统文件选择器获取文件，直接读取文件内容，无需访问外部存储目录。

修复步骤 #

步骤1：更新权限请求逻辑

删除原有的Permission.storage请求，改为根据Android版本判断是否需要申请对应媒体权限（按需选择），或直接移除权限请求代码（仅用文件选择器可省略）：

Future<void> _requestPermissions() async {
  if (Platform.isAndroid) {
    final androidInfo = await DeviceInfoPlugin().androidInfo;
    if (androidInfo.version.sdkInt >= 33) {
      // Android 13+ 请求媒体权限（按需添加）
      await Permission.photos.request();
      // await Permission.audio.request();
      // await Permission.video.request();
    } else {
      // Android 12及以下 请求存储权限
      await Permission.storage.request();
    }
  }
}

注：若仅使用file_picker选择文件，无需申请任何存储权限，可直接删除_requestPermissions的调用及相关代码。

步骤2：更新AndroidManifest.xml

移除旧存储权限，添加Android 13+媒体权限（按需添加）：

<!-- 移除旧权限 -->
<!-- <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" /> -->
<!-- <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" /> -->

<!-- Android 13+ 媒体权限（按需添加） -->
<uses-permission android:name="android.permission.READ_MEDIA_IMAGES" />
<uses-permission android:name="android.permission.READ_MEDIA_AUDIO" />
<uses-permission android:name="android.permission.READ_MEDIA_VIDEO" />

<!-- 保留其他必要权限 -->
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.CAMERA" />

同时移除android:requestLegacyExternalStorage="true"（Android 13+已失效）。

2. 解决文件处理失败问题 #

原因分析 #

• 直接使用utf8.decode(file.bytes!)会导致非文本文件（如图片、PDF、二进制文件）解码失败；
• 未处理file.bytes为null的情况；
• OpenAI Embeddings接口仅支持文本输入，非文本文件需先转换为文本格式（如PDF提取文本、图片OCR）。

修复步骤 #

步骤1：安全处理文件字节

避免强制解包，添加空值判断：

if (result != null) {
  PlatformFile file = result.files.first;
  if (file.bytes == null) {
    setState(() {
      _messages.add("Jadlu: 无法读取文件内容");
    });
    return;
  }
  // 后续处理
}

步骤2：限制文件选择类型

在选择文件时仅允许文本类文件，避免用户上传非文本格式：

FilePickerResult? result = await FilePicker.platform.pickFiles(
  type: FileType.custom,
  allowedExtensions: ['txt', 'md', 'csv', 'json'],
);

步骤3：处理非文本文件（可选）

若需支持PDF、图片等文件，添加对应文本提取逻辑：

• PDF文件：使用pdf包提取文本；
• 图片文件：使用tesseract_ocr进行OCR识别；
  示例（PDF提取）：

// 添加依赖：pdf: ^3.10.8
import 'package:pdf/pdf.dart';
import 'package:pdf/widgets.dart' as pw;

Future<String> extractPdfText(Uint8List bytes) async {
  final pdf = pw.Document.load(bytes);
  String text = '';
  for (var page in pdf.pages) {
    text += page.text;
  }
  return text;
}

在_sendFile中调用：

String inputText;
if (file.extension == 'pdf') {
  inputText = await extractPdfText(file.bytes!);
} else {
  try {
    inputText = utf8.decode(file.bytes!);
  } catch (e) {
    setState(() {
      _messages.add("Jadlu: 无法解码文件，请上传文本格式文件");
    });
    return;
  }
}

// 调用OpenAI接口
final response = await http.post(
  Uri.parse('https://api.openai.com/v1/embeddings'),
  headers: {
    'Authorization': 'Bearer $_apiKey',
    'Content-Type': 'application/json',
  },
  body: jsonEncode({
    'model': 'text-embedding-ada-002',
    'input': inputText,
  }),
);

步骤4：添加错误日志

在catch块打印错误详情，方便排查：

catch (error) {
  print("文件处理错误: $error");
  setState(() {
    _messages.add("Jadlu: Échec du traitement du fichier en raison d'une erreur.");
  });
}

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