TCPDF生成PDF时第二页表头与表体对齐异常问题求助

以下是针对TCPDF生成发票时跨页表头偏移问题的具体解决方法：

核心原因 #

分页后TCPDF的X坐标未自动重置到表格起始位置，导致表头绘制时沿用了上一页末尾的偏移值，进而和表体对齐错乱。

解决步骤 #

1. 固定表格起始X坐标并强制重置 #

在绘制表格前先记录表格的起始X位置，每次绘制表头（包括分页后）都强制将X坐标设置到该位置，确保表头和表体起始点一致。

示例代码：

// 定义表格起始X坐标（可根据需求调整）
$table_start_x = 20;

// 封装表头绘制函数
function drawInvoiceHeader($pdf, $table_start_x) {
    $pdf->SetX($table_start_x); // 强制定位到表格起始X
    // 表头单元格（宽度需和表体完全对应）
    $pdf->Cell(35, 10, '商品名称', 1, 0, 'C');
    $pdf->Cell(20, 10, '数量', 1, 0, 'C');
    $pdf->Cell(30, 10, '单价', 1, 0, 'R');
    $pdf->Cell(30, 10, '金额', 1, 1, 'R');
}

// 初始绘制表头
drawInvoiceHeader($pdf, $table_start_x);

// 循环绘制商品行
foreach ($productList as $product) {
    // 检查是否需要分页（判断剩余高度是否能放下当前行）
    if ($pdf->GetY() + 10 > $pdf->getPageHeight() - $pdf->getFooterMargin()) {
        $pdf->AddPage();
        drawInvoiceHeader($pdf, $table_start_x); // 分页后重新绘制表头
    }
    
    $pdf->SetX($table_start_x); // 表体行同样强制对齐起始X
    $pdf->Cell(35, 10, $product['name'], 1, 0, 'L');
    $pdf->Cell(20, 10, $product['quantity'], 1, 0, 'C');
    $pdf->Cell(30, 10, $product['price'], 1, 0, 'R');
    $pdf->Cell(30, 10, $product['total'], 1, 1, 'R');
}

2. 确保表头与表体单元格宽度完全一致 #

表头和表体的每个Cell()方法的宽度参数必须严格对应，哪怕1个单位的差异都会导致对齐错乱。

3. 排查额外的X偏移操作 #

检查代码中是否有$pdf->SetX()、$pdf->Ln()或其他改变X坐标的操作，分页后这些偏移不会自动重置，需要手动恢复到表格起始位置。

4. 辅助：使用resetX()快速重置基础坐标 #

如果表格从页面左边缘开始绘制，可在绘制表头前调用$pdf->resetX()，将X坐标重置到当前页的左边界，再绘制表头。

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