本文详解 Laravel 中使用 DOMPDF 生成 PDF 时出现 “Undefined variable $invoice” 的根本原因及正确传参方式，重点说明 loadView() 方法的数据传递规范与常见误区。
本文详解 laravel 中使用 dompdf 生成 pdf 时出现 “undefined variable $invoice” 的根本原因及正确传参方式，重点说明 `loadview()` 方法的数据传递规范与常见误区。
在 Laravel 中集成 DOMPDF 生成 PDF 时，一个高频报错是：视图中访问 $invoice->institution 报错 Undefined variable: invoice。该问题并非 DOMPDF 特有，而是源于 Laravel 视图数据绑定机制的误用。
回顾原始代码：
$invoice = array($this->invoice_form($request));
$pdf = PDF::loadView('pdf-generation.invoice', $invoice);
此处将 $invoice 定义为索引数组（如 [0 => (object) [...]]），而 PDF::loadView() 的第二个参数要求是一个 关联数组（key-value），其中 key 将作为视图中的变量名。因此，上述写法实际向视图传递了类似 ['0' => $invoiceObject] 的结构，导致视图中无法通过 $invoice 访问，只能写成 $0->institution（显然非法且不可读）。
✅ 正确做法是：显式以键名 'invoice' 传递对象，确保视图能直接解析 $invoice 变量：
$invoiceData = $this->invoice_form($request); // 返回 object
$pdf = PDF::loadView('pdf-generation.invoice', compact('invoiceData'));
// 或等价写法：
// $pdf = PDF::loadView('pdf-generation.invoice', ['invoiceData' => $invoiceData]);
随后，在 pdf-generation.invoice.blade.php 中即可安全使用：
<span style="font-weight: bold; float: left;">{{ $invoiceData->institution->name ?? 'N/A' }}</span>
⚠️ 注意事项：
- compact('invoice') 要求变量名与字符串键名严格一致（即 PHP 变量必须叫 $invoice）；若你已将对象赋值给 $invoiceData，则应使用 compact('invoiceData')。
- DOMPDF 对 CSS 支持有限，避免使用 Flexbox、Grid 或复杂伪类；内联样式更稳妥。
- 若 institution 或 user 可能为 null（如未登录用户调用 Auth::user()），务必添加空值判断（如 ?? 或 optional()），防止 PDF 渲染中断。
- 建议在 invoice_form() 中统一处理数据组装逻辑，避免在控制器中重复调用 $this->institution() 和 $this->user()。
总结：DOMPDF 的 loadView() 本质复用 Laravel 的视图渲染器，其数据传递规则与 view() 完全一致——必须传入关联数组，键即视图变量名。修正传参方式后，“Undefined variable” 错误将立即消失，PDF 生成流程也将稳定可靠。
