WeasyPrint page-break-after失效：Jinja模板循环分页异常求助

问题原因分析 #

• 空的<p>标签容易被WeasyPrint忽略，导致单分页标签无法触发段间分页；重复添加分页标签虽然能强制触发分页，但最后一个元素后的分页会产生多余空白页。
• 循环中给每个元素都加page-break-after: always，会导致最后一个元素末尾也强制分页，必然多出空白页。

解决方案 #

1. 仅对非最后一个元素添加分页 #

利用Jinja的loop.last变量，跳过最后一个元素的分页标签，既实现段间分页，又避免末尾空白页。同时给分页标签添加非空内容（比如 ），防止空标签被WeasyPrint忽略：

{% for stuff in stuffs %}
# 替换为你的数据段渲染代码
{% if not loop.last %}
<p style="page-break-after: always;">&nbsp;</p>
{% endif %}
{% endfor %}

2. 给内容容器设置分页样式 #

如果每个数据段都有独立容器（比如<div>），可以通过CSS直接控制分页，更简洁易维护：

{% for stuff in stuffs %}
<div class="data-section">
# 替换为你的数据段渲染代码
</div>
{% endfor %}

对应的CSS规则：

.data-section {
    page-break-after: always;
}
.data-section:last-child {
    page-break-after: avoid;
}

WeasyPrint支持:last-child伪类，这样最后一个容器不会触发分页，同时确保中间容器后自动分页。

3. 排查CSS干扰项 #

检查全局CSS是否存在以下影响分页的属性：

• page-break-inside: avoid：父元素设置该属性可能阻止内部分页触发
• overflow: hidden：可能导致分页规则不生效
• 固定高度设置：元素高度固定可能导致内容未填满一页，干扰分页逻辑

内容的提问来源于stack exchange，提问作者Jamie J