Flutter中如何覆盖PDF文件？动态PDF重生成异常排查

阿华AIGC实验室

2026-5-11

解决PDF重新生成后仍显示旧内容的问题

我帮你分析了一下，你遇到的这个问题在Flutter使用pdf包生成动态PDF时很常见，主要有几个核心原因，下面是针对性的解决方案：

1. 每次生成前重置PDF Document实例

这是最可能的根源：如果你的pdf变量是页面初始化时创建的全局/成员变量，那么每次调用writeOnPdf时，你其实是在原有文档的基础上追加新页面，而不是生成一个全新的PDF文档。

修改你的writeOnPdf方法，在开头重新初始化pw.Document()：

writeOnPdf(context) async {
  // 关键：每次生成新PDF前，重新创建Document实例
  pdf = pw.Document();
  
  final roboto = await rootBundle.load('assets/fonts/Roboto-Regular.ttf');
  var robotoF = pw.Font.ttf(roboto);
  final robotobold = await rootBundle.load('assets/fonts/Roboto-Bold.ttf');
  var robotoB = pw.Font.ttf(robotobold);
  
  pdf.addPage(pw.MultiPage(
    // 你的现有配置和布局代码...
  ));
}

2. 确保旧文件被彻底删除并覆盖

直接调用writeAsBytes可能在某些场景下（比如文件被PDF阅读器占用）无法完全覆盖旧内容。我们可以先删除旧文件，等待删除完成后再写入新内容，同时通知系统刷新媒体库，避免系统缓存旧文件。

修改你的savePDF函数：

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

Future<File> savePDF() async {
  // 用path_provider获取标准外部存储路径，避免硬编码兼容性问题
  final externalDir = await getExternalStorageDirectory();
  if (externalDir == null) {
    throw Exception("无法访问外部存储，请检查权限");
  }

  // 递归创建应用专属的Invoices目录（不存在则创建）
  final appInvoiceDir = Directory(path.join(externalDir.path, "Myxyzapp", "Invoices"));
  await appInvoiceDir.create(recursive: true);

  final filePath = path.join(appInvoiceDir.path, 'myxyzapp-invoice-$invoiceNo.pdf');
  final pdfFile = File(filePath);

  // 如果旧文件存在，先删除
  if (await pdfFile.exists()) {
    await pdfFile.delete();
  }

  // 写入新的PDF内容
  await pdfFile.writeAsBytes(pdf.save());

  // 通知Android系统扫描新文件，避免预览缓存
  if (Platform.isAndroid) {
    const MethodChannel mediaScannerChannel = MethodChannel('com.yourapp.media_scanner');
    try {
      await mediaScannerChannel.invokeMethod('scanFile', {'path': filePath});
    } catch (e) {
      print("媒体扫描失败: $e");
    }
  }

  return pdfFile;
}

配套配置（Android）

为了确保存储权限正常，在android/app/src/main/AndroidManifest.xml中添加：

<!-- 存储权限 -->
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />

<!-- 针对Android 10+的兼容配置 -->
<application
    ...
    android:requestLegacyExternalStorage="true">
    ...
</application>