Flutter中PdfDocument.openFile读取Hive存储路径报RENDER_ERROR

可能的原因 #

• File Picker获取的是临时文件路径，重启后系统会清理临时文件，导致路径失效
• 存储的路径不是应用私有目录的绝对路径，重启后文件访问权限或路径上下文变化
• 重启后未重新申请文件访问权限，导致无法读取文件
• Hive存储的路径存在格式错误（如转义字符、不完整路径）

解决方案 #

1. 验证文件路径有效性 #

使用File类先判断文件是否存在，避免无效路径直接调用PdfDocument.openFile：

final savedPath = Hive.box('settings').get('pdf_path');
if (savedPath != null) {
  final file = File(savedPath);
  if (await file.exists()) {
    // 正常打开PDF
    final pdfDoc = await PdfDocument.openFile(savedPath);
  } else {
    // 文件不存在，提示用户重新选择
    print('PDF文件已不存在，请重新选择');
  }
}

2. 将PDF复制到应用私有目录再存储路径 #

避免依赖临时文件，把选中的PDF复制到应用专属的文档目录，存储这个永久路径：

import 'package:path_provider/path_provider.dart';

// 选择PDF时的逻辑
final pickedFile = await FilePicker.platform.pickFiles(type: FileType.pdf);
if (pickedFile != null) {
  final sourceFile = File(pickedFile.files.single.path!);
  // 获取应用私有文档目录
  final appDocDir = await getApplicationDocumentsDirectory();
  // 生成目标文件路径（保留原文件名）
  final targetPath = '${appDocDir.path}/${sourceFile.path.split('/').last}';
  // 复制文件到私有目录
  await sourceFile.copy(targetPath);
  // 将目标路径存入Hive
  await Hive.box('settings').put('pdf_path', targetPath);
}

3. 确保重启后拥有文件访问权限 #

Android 13+需要申请媒体文件读取权限，iOS也需配置相关权限：

• AndroidManifest.xml添加权限：

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

• 使用permission_handler包运行时申请权限：

import 'package:permission_handler/permission_handler.dart';

// 重启后先检查权限
final status = await Permission.manageExternalStorage.request();
if (status.isGranted) {
  // 执行文件操作
} else {
  // 提示用户开启权限
}

4. 改用字节流方式打开PDF #

绕开路径问题，直接读取文件字节流打开：

final savedPath = Hive.box('settings').get('pdf_path');
if (savedPath != null) {
  final file = File(savedPath);
  if (await file.exists()) {
    final bytes = await file.readAsBytes();
    final pdfDoc = await PdfDocument.openBytes(bytes);
  }
}

5. 检查Hive存储的路径格式 #

打印存储的路径，确认是完整的绝对路径，无多余转义字符：

final savedPath = Hive.box('settings').get('pdf_path');
print('存储的PDF路径：$savedPath');
// 对比选择文件时的原始路径，确认一致

内容的提问来源于stack exchange，提问作者원종서