使用 tcpdf + fpdi 导入现有 pdf 时，若首页未显示，通常是因为未在循环开始前调用 `addpage()`，导致第一页模板被绘制在不存在的页面上。正确做法是：每导入一页前先添加新页面。
在 TCPDF 结合 FPDI（如 TcpdfFpdi）进行 PDF 页面导入时，一个常见但容易被忽视的逻辑错误是：在调用 importPage() 和 useTemplate() 之前，未确保当前文档已存在目标页面。你的原始代码中，首次循环（$i = 1）直接执行 importPage(1) 和 useTemplate()，但此时 PDF 文档尚无任何页面（AddPage() 尚未调用），因此该模板被静默丢弃——这就是首页“消失”的根本原因。
✅ 正确写法是：先 AddPage()，再 importPage()，最后 useTemplate()。每一页都严格遵循此顺序：
$pdf = new TcpdfFpdi('P', 'mm', 'A4', true, 'UTF-8', false, true);
$pdf->SetCreator('TCPDF Name');
$pdf->SetAuthor('TCPDF Author');
$pdf->SetTitle('TCPDF title');
$pdf->SetSubject('TCPDF Tutorial');
$pdf->SetKeywords('TCPDF, FPDI, PDF import');
// 加载源 PDF 并获取总页数
$pageCount = $pdf->setSourceFile('/path/to/source.pdf');
// 每页单独处理：先新建页，再导入并渲染模板
for ($i = 1; $i <= $pageCount; $i++) {
$pdf->AddPage(); // ✅ 关键：为当前页创建空白画布
$tplIdx = $pdf->importPage($i); // 导入第 i 页为模板
$pdf->useTemplate($tplIdx, 0, 0, 210, 297); // 渲染到整页（A4 尺寸：210×297 mm）
}
$pdf->Output(public_path('merged.pdf'), 'F');⚠️ 注意事项：
- AddPage() 必须在 useTemplate() 之前调用，且每次循环仅调用一次；
- 不要对最后一页额外调用 AddPage()（即避免 $i
- useTemplate() 的宽高参数建议使用实际纸张尺寸（如 A4 为 210, 297），单位需与初始化一致（本例为 'mm'）；
- 确保 TcpdfFpdi 类已正确继承并兼容 TCPDF v6+ 与 FPDI v2+（推荐使用 setasign/fpdi-tcpdf 官方组合包）。
通过这一调整，所有源 PDF 页面（包括第一页）都将被完整、准确地导入并渲染，彻底解决“首页丢失”问题。
