使用mPDF生成PDF时出现pagebreakavoidchecked="true";异常内容求助

我之前也碰到过mPDF这个恼人的兼容bug，结合你的使用场景，给你几个实用的排查和解决思路：

1. 优先升级mPDF版本 #

mPDF的旧版本（尤其是7.x及更早）对CSS分页属性的支持存在不少bug，pagebreakavoidchecked="true";这个消息大概率是某版本的内部调试输出遗漏。建议直接升级到最新稳定版（比如8.x系列），很多分页相关的兼容性问题都在新版本中得到了修复。

2. 替换CSS分页属性的写法 #

试试用mPDF的私有前缀属性，或者换用等价的分页控制逻辑绕开bug：

• 给样式加上mPDF专属前缀，强制识别：

.cabecera_anuncio {
  page-break-inside: avoid;
  -mpdf-page-break-inside: avoid;
}

• 用page-break-after + page-break-before组合替代，同样能实现header和content不拆分的效果：

.cabecera_anuncio {
  page-break-after: avoid; /* 禁止header后分页 */
}
.contenido_anuncio {
  page-break-before: avoid; /* 禁止content前分页 */
}

3. 检查HTML结构与mPDF解析配置 #

• 确保HTML5标签（<article>、<header>）能被mPDF正确解析，初始化时开启HTML5解析并关闭调试模式：

$mpdf = new \Mpdf\Mpdf([
    'mode' => 'UTF-8',
    'enable_html5_parser' => true,
    'debug' => false, /* 关闭调试避免输出内部变量 */
]);

• 简化cabecera_anuncio内部的嵌套层级，复杂嵌套容易导致mPDF的CSS解析异常。

4. 调整样式应用方式 #

如果外部样式表解析有问题，试试用内联样式直接写在标签上：

<header class="cabecera_anuncio" style="page-break-inside: avoid;">
  <!-- header内容 -->
</header>

5. 排查页眉页脚的冲突 #

异常消息是在添加页眉页脚后出现的，检查你的页眉页脚代码：

• 不要在页眉页脚中使用JavaScript（mPDF对JS支持非常有限）；
• 确保页眉页脚的CSS没有和正文的分页属性冲突，比如避免在页眉中设置分页相关属性。

如果以上方法都不行，还可以尝试把每个<article>作为独立块，用mPDF的WriteHTML分块写入，配合手动分页控制，确保header和content始终在同一页。

内容的提问来源于stack exchange，提问作者Rafael Linux User