Flutter Printing包部署Web应用后PDF打印功能失效求助

问题背景 #

• Flutter版本：3.16.1，printing包版本：5.11.1
• 调试模式下执行以下代码可正常唤起打印对话框：

await Printing.layoutPdf(
  format: PdfPageFormat.a4,
  onLayout: (PdfPageFormat format) async {
    return pdf.save();
  },
);

• 部署后同一浏览器中执行无任何反应，PDF生成逻辑已验证正常，Web目标配置无误

排查与解决思路 #

1. 检查内容安全策略（CSP）配置 #

部署后的Web应用若设置了严格CSP，可能阻止printing包通过blob URL加载PDF。需在web/index.html中调整CSP规则，允许blob资源：

<meta http-equiv="Content-Security-Policy" content="default-src 'self'; script-src 'self' 'unsafe-eval'; style-src 'self' 'unsafe-inline'; img-src 'self' data: blob:;">

根据实际部署环境调整规则，确保blob:被包含在资源允许列表中。

2. 排查编译模式与树摇问题 #

Flutter Web的release编译可能因树摇移除printing包的Web端依赖：

• 编译时尝试添加--no-tree-shake-icons参数，避免资源被误删
• 打开浏览器控制台（F12）查看报错信息，重点关注ReferenceError或Failed to load blob:类错误，定位缺失的依赖或资源

3. 替换为原生浏览器API实现打印 #

绕开printing包的封装，直接使用浏览器API处理PDF打印：

import 'dart:html' as html;
import 'dart:typed_data';

void printPdf(Uint8List pdfBytes) {
  final blob = html.Blob([pdfBytes], 'application/pdf');
  final url = html.Url.createObjectUrlFromBlob(blob);
  final anchor = html.AnchorElement(href: url)
    ..setAttribute('target', '_blank')
    ..click();
  html.Url.revokeObjectUrl(url);
}

调用此方法传入PDF字节数据，直接触发浏览器的PDF预览与打印流程。

4. 检查浏览器权限与兼容性 #

• 确认用户未阻止网站的弹出窗口权限（部分浏览器在HTTPS环境下会默认限制弹出）
• 验证浏览器支持PDF原生预览（如Chrome、Firefox均支持，小众浏览器可能需插件）
• 尝试在隐私模式下测试，排除浏览器插件或缓存干扰

5. 升级依赖与框架版本 #

• 升级Flutter至最新稳定版，修复Web端已知的兼容性问题
• 查看printing包的官方Issue列表，确认是否存在部署后打印的已知问题及修复方案

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