Laravel 7 导出产品列表PDF文件显示空白问题咨询

排查解决步骤 #

• 第一步：确认路由匹配是否正常
  你返回的响应内容和定义的PDF视图完全无关，优先排查路由问题：
  1. 把/pdfproduct路由移到路由文件最顶部，避免被前缀相似的路由提前匹配拦截
  2. 在控制器PDFProducts方法第一行加入dd('路由访问正常');，访问/pdfproduct路径，如果能输出该内容说明路由匹配正常，否则检查控制器命名空间、类名、方法名的拼写和大小写是否和路由配置一致。
• 第二步：修复视图语法错误
  你的PDF视图存在明显语法错误，会导致渲染失败：
  你写的@foreach($products as $product)没有定义$key变量，但后续用到了{{ $key+1 }}，会报未定义变量错误，改为：

  @foreach($products as $key => $product)
  

  调试阶段可以先直接返回视图验证是否能正常渲染：

  public function PDFProducts(){
      $products = Product::all();
      // 临时改为直接返回视图，排查渲染错误
      return view('pdf-products', compact('products'));
  }
  

  页面正常显示产品列表后再继续下一步排查PDF生成逻辑。
• 第三步：适配dompdf渲染规则
  常用的laravel-dompdf扩展对前端特性支持有限，需要做以下适配：
  1. 移除外部CDN资源：把bootstrap的CSS代码直接内联到<style>标签中，避免外部资源加载失败
  2. 移除table-responsive类：dompdf对响应式表格支持较差，直接固定表格宽度即可
  3. 移除冗余代码：视图里定义了$count_product但未使用，可以直接删除对应的@php代码块
• 第四步：验证PDF生成逻辑
  视图调试正常后，修改控制器方法验证PDF生成：
  1. 先尝试把PDF保存到本地，排除stream输出的问题：

  public function PDFProducts(){
      $products = Product::all();
      $pdf = \PDF::loadView('pdf-products', compact('products'));
      // 保存到本地storage/app/public目录
      $pdf->save(storage_path('app/public/products.pdf'));
      return 'PDF生成完成，请去storage目录查看';
  }
  

  2. 如果本地生成的PDF正常，再改回return $pdf->stream('products.pdf');即可。
• 第五步：检查扩展包配置
  如果上述步骤都无效，确认barryvdh/laravel-dompdf扩展是否正确安装配置：
  1. 运行composer show barryvdh/laravel-dompdf确认扩展已安装
  2. 检查config/app.php中是否已添加服务提供者和别名：

  // 服务提供者
  Barryvdh\DomPDF\ServiceProvider::class,
  // 别名
  'PDF' => Barryvdh\DomPDF\Facade::class,
  

  3. 运行php artisan vendor:publish --provider="Barryvdh\DomPDF\ServiceProvider"发布配置文件，可根据需要调整内存限制、字体路径等配置。

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