如何阻止 mPDF 因 rowspan 内容过多而自动缩放表格字体

夜浩大大_9913

发布时间：2026-03-26 17:50:27

335人浏览过

来源于php中文网

原创

如何阻止 mPDF 因 rowspan 内容过多而自动缩放表格字体

本文详解 mPDF 中表格因 rowspan 单元格内容过长导致字体被强制缩小的问题根源与解决方案，重点介绍禁用自动缩放、启用分页避让、优化嵌套结构等实战方法，并提供可直接运行的配置与代码示例。

本文详解 mpdf 中表格因 `rowspan` 单元格内容过长导致字体被强制缩小的问题根源与解决方案，重点介绍禁用自动缩放、启用分页避让、优化嵌套结构等实战方法，并提供可直接运行的配置与代码示例。

在使用 mPDF 生成 PDF 报表时，一个常见却易被忽视的问题是：当 HTML 表格中存在跨多行的

单元格，且其内部文本内容较长（尤其含换行、段落或嵌套元素）时，mPDF 可能会无视 shrink_tables_to_fit => 1 等设置，仍强行缩小整个表格字体，以试图将内容“塞进”当前页。这不仅破坏排版一致性，更违背业务需求——理想行为应是：内容超限时自动分页，而非压缩可读性。

根本原因：嵌套表格 + rowspan 触发布局误判

如答案所指出，该问题高频出现在 表格内嵌套表格（Table-in-Table）且外层存在 rowspan 的场景中。mPDF 的表格渲染引擎在计算跨行单元格高度时，若内部嵌套结构复杂（如含

、

、多行文本或子表格），会错误预估行高，进而触发“安全缩放”机制（shrink_tables_to_fit 本质是兜底策略，非分页指令）。此时，即使显式设置 shrink_tables_to_fit => 0，部分版本仍可能失效。

正确解决方案（四步法）

✅ 第一步：彻底禁用自动缩放

将 shrink_tables_to_fit 明确设为 0（而非 1），并移除所有可能触发缩放的冗余配置：

$mpdf = new \Mpdf\Mpdf([
    'shrink_tables_to_fit' => 0,     // 关键：禁用缩放（0=关闭，1=启用）
    'autoScriptToLang'     => true,
    'autoLangToFont'       => true,
    'use_kwt'              => true,
]);

⚠️ 注意：shrink_tables_to_fit => 1 是“允许缩放”，=> 0 才是“禁止缩放”。原配置中的 1 恰恰是问题诱因。

✅ 第二步：强制分页：用 CSS 控制断点

在含 rowspan 的

或其父上添加 page-break-inside: avoid，并确保表格本身支持分页：

<style>
  .breakable-table { page-break-inside: auto; }
  .breakable-table td[rowspan] { 
    page-break-inside: avoid; 
    vertical-align: top;
  }
  .breakable-table tr { page-break-inside: avoid; }
</style>

<table class="breakable-table" border="1">
  <tr>
    <td rowspan="5">长文本内容……可能跨越多行，包含<br>换行符和<br>其他格式</td>
    <td>普通单元格</td>
  </tr>
  <!-- 更多行 -->
</table>

✅ 第三步：避免嵌套表格（关键实践）

如答案提示，Table-in-Table 是主要诱因。请重构 HTML：

❌ 避免：...

✅ 推荐：用 CSS Grid/Flex 布局替代内嵌表格；或拆分为独立表格+空行分隔；或改用

+ display: table-cell 模拟（需测试兼容性）。

✅ 第四步：主动控制分页位置（高级）

对高风险 rowspan 区域，手动插入分页符：

<!-- 在可能溢出前插入 -->
<div style="page-break-before: always;"></div>
<!-- 或针对特定行 -->
<tr style="page-break-before: always;">
  <td colspan="2">新页开始的内容</td>
</tr>

完整可运行示例

<?php
require_once __DIR__ . '/vendor/autoload.php';

$mpdf = new \Mpdf\Mpdf([
    'shrink_tables_to_fit' => 0,
    'margin_left'          => 15,
    'margin_right'         => 15,
    'margin_top'           => 20,
    'margin_bottom'        => 20,
]);

$html = '
<style>
.breakable-table { 
  page-break-inside: auto; 
  width: 100%;
}
.breakable-table td[rowspan] { 
  page-break-inside: avoid; 
  vertical-align: top;
}
</style>

<table class="breakable-table" border="1">
  <tr>
    <th>标题A</th>
    <th>标题B</th>
  </tr>
  <tr>
    <td rowspan="4" style="height: 200px;">
      这里是超长 rowspan 内容：<br>
      第1行<br>第2行<br>第3行<br>第4行<br>第5行<br>
      （内容足够撑满一页时，mPDF 将自动分页而非缩放）
    </td>
    <td>数据1</td>
  </tr>
  <tr><td>数据2</td></tr>
  <tr><td>数据3</td></tr>
  <tr><td>数据4</td></tr>
</table>';

$mpdf->WriteHTML($html);
$mpdf->Output('rowspan-no-shrink.pdf', 'D');