Flutter使用pdfx加载Asset中PDF报PdfRendererException求助

第一步：检查pubspec.yaml的Asset配置 #

这是最容易忽略的关键步骤，必须确保PDF文件已正确注册到项目配置中：

flutter:
  assets:
    - assets/pdf/your_file.pdf  # 替换为你项目中PDF的实际路径，层级要完全匹配

注意：如果PDF放在assets根目录下，就写- assets/your_file.pdf；如果是整个目录下的文件，也可以写- assets/pdf/来批量注册该目录下所有资源。配置后务必执行flutter pub get。

第二步：修复open_file插件无反应的问题 #

open_file无法直接读取Asset资源，因为它需要本地文件路径。你需要先把Asset文件复制到临时目录，再调用插件打开：

import 'package:open_file/open_file.dart';
import 'package:path_provider/path_provider.dart';
import 'dart:io';
import 'package:flutter/services.dart';

Future<void> openPdfFromAsset() async {
  // 读取Asset文件字节数据
  final byteData = await rootBundle.load('assets/pdf/your_file.pdf');
  // 获取设备临时目录
  final tempDir = await getTemporaryDirectory();
  final tempFile = File('${tempDir.path}/temp_pdf_file.pdf');
  // 将Asset数据写入临时文件
  await tempFile.writeAsBytes(byteData.buffer.asUint8List());
  // 打开临时文件
  await OpenFile.open(tempFile.path);
}

之前无反应就是因为直接传入了Asset路径，插件无法识别打包在App内的资源。

第三步：解决pdfx插件的"文件未找到"异常 #

pdfx支持直接读取Asset，但路径写法必须严格匹配pubspec中的配置：

• 正确写法：'assets/pdf/your_file.pdf'（和pubspec里的路径完全一致）
• 错误写法：添加file://前缀、路径拼写错误、大小写不匹配（iOS/Android对路径大小写敏感）

正确使用pdfx的示例代码：

import 'package:pdfx/pdfx.dart';

final pdfController = PdfController(
  document: PdfDocument.openAsset('assets/pdf/your_file.pdf'),
);

// 在Widget中渲染PDF
PdfView(controller: pdfController)

如果仍报错，执行flutter clean清除缓存后重新运行项目，同时确认PDF文件确实存在于指定路径中。

通用排查要点 #

• 核对代码中的Asset路径与项目实际文件路径、pubspec配置完全一致
• 检查文件名是否有特殊字符或空格，尽量使用小写字母和下划线命名
• 确认Android/iOS的权限配置（读取本地文件权限，不过临时目录一般无需额外权限）

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