You need to enable JavaScript to run this app. Firebase Storage上传PDF后在Flutter中持久下载与按需打开实现
优惠活动
大模型
产品
解决方案
定价
更多

Firebase Storage上传PDF后在Flutter中持久下载与按需打开实现

现有代码的核心失效原因
  • 存储路径选择错误:当前使用的Directory.systemTemp是系统临时缓存目录,系统会在存储空间不足、应用被后台清理时随时删除该目录下的文件,无法满足应用重启后依然可访问的持久化要求
  • 文件类型硬编码错误:不管下载的是PDF还是图片,都把本地文件命名为tmp.jpg,直接把不同格式的二进制流都套上jpg后缀,不仅PDF完全无法识别,长期来看也会导致非jpg格式的图片出现解码失败的问题
  • 展示逻辑不匹配:用Image.memory组件解析下载的字节流,该组件仅能解码jpg、png等图片格式的二进制数据,完全无法识别PDF的文件结构,自然无法正常展示内容
  • 逻辑冗余重复:下载流程里既通过http请求拉取了完整文件流,又调用Storage的写入方法重复下载,浪费流量的同时也容易出现文件写入冲突
  • 缺少PDF查看核心能力:没有对接PDF渲染组件,也没有本地文件打开的逻辑,就算文件下载正确也无法触发查看动作
可直接匹配现有代码的修正方案

1. 替换为合法的持久存储路径

删除临时目录相关逻辑,改用应用专属文档目录存放PDF,该目录下的文件除非用户手动卸载应用,否则不会被系统自动清理。需要引入path_provider插件获取路径:

// 获取应用持久存储目录
final Directory appDocDir = await getApplicationDocumentsDirectory();
// 从Firebase Storage引用中提取原始文件名,保留正确后缀
final String fileName = await ref.getName();
final File localPdfFile = File('${appDocDir.path}/$fileName');

2. 重构下载流程

删除冗余的http请求逻辑,直接调用Firebase Storage提供的文件写入能力下载内容,增加本地文件存在判断,避免重复下载:

Future<void> downloadFile(StorageReference ref) async {
  // 先判断本地是否已存在该PDF
  if (await localPdfFile.exists()) {
    _openPdfViewer(localPdfFile);
    return;
  }
  // 不存在则下载到本地持久目录
  final StorageFileDownloadTask downloadTask = ref.writeToFile(localPdfFile);
  final taskSnapshot = await downloadTask.future;
  print('下载完成:${taskSnapshot.totalByteCount} 字节');
  // 下载完成后直接触发查看
  _openPdfViewer(localPdfFile);
}

如果是图片格式的文件,可以保留原有SnackBar展示逻辑,仅需把硬编码的tmp.jpg替换为根据实际文件后缀生成的合法文件名即可。

3. 实现PDF查看逻辑

引入flutter_pdfview插件实现应用内PDF渲染,不需要依赖外部第三方应用,加载本地文件路径即可完成内容展示:

void _openPdfViewer(File pdfFile) {
  Navigator.push(
    context,
    MaterialPageRoute(
      builder: (context) => PdfPreviewPage(pdfFile: pdfFile),
    ),
  );
}

class PdfPreviewPage extends StatelessWidget {
  final File pdfFile;
  const PdfPreviewPage({super.key, required this.pdfFile});

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: const Text('PDF预览')),
      body: PdfView(
        controller: PdfController(
          document: PdfDocument.openFile(pdfFile.path),
        ),
      ),
    );
  }
}

4. 修正上传环节的元数据配置

原来的上传逻辑中contentType判断要针对PDF格式做兼容,避免元数据识别错误导致Storage端下载异常:

// upload方法内调整
String contentType;
if (_extension == 'pdf') {
  contentType = 'application/pdf';
} else {
  contentType = '$_pickType/$_extension';
}
final StorageUploadTask uploadTask = storageRef.putFile(
  File(filePath),
  StorageMetadata(contentType: contentType),
);

内容的提问来源于stack exchange,提问作者srk2k14

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.12 17:54:04