如何使用XSL-FO实现随内容自适应高度的单页小票打印？

核心是把固定页面尺寸改为宽度固定、高度随内容自适应的单页配置，同时关闭所有自动分页逻辑，具体实现步骤如下：

1. 配置动态尺寸的页面母版 #

在fo:layout-master-set中定义小票专用的页面模板，固定小票物理宽度，页面高度设为自动，去掉不需要的页眉页脚区域，避免多余留白：

<fo:layout-master-set>
  <fo:simple-page-master master-name="thermal-receipt"
    page-width="80mm" <!-- 按实际纸张替换，常见规格为58mm/80mm -->
    page-height="auto"
    margin="2mm"> <!-- 小票边距按需调整，不要留过大空白 -->
    <fo:region-body/>
    <!-- 小票无特殊需求不要配置region-before（页眉）、region-after（页脚） -->
  </fo:simple-page-master>
</fo:layout-master-set>

2. 配置内容流禁止分页 #

页面序列绑定上面的小票母版，给内容块加上禁止内部分页的属性，移除之前A4打印逻辑里所有强制分页、自动分页的相关配置：

<fo:page-sequence master-reference="thermal-receipt">
  <fo:flow flow-name="xsl-region-body">
    <fo:block page-break-inside="avoid">
      <!-- 此处放所有小票内容：门店抬头、商品明细、金额合计、支付信息、二维码/条码等 -->
    </fo:block>
  </fo:flow>
</fo:page-sequence>

3. 兼容与踩坑说明 #

• 渲染引擎版本要求：Apache FOP请使用2.6及以上版本，低版本对page-height="auto"的动态页高支持存在缺陷；RenderX XEP、Antenna House等商业引擎全版本支持该配置。
• 打印端配置：生成PDF/打印指令后，要在打印机驱动中选择「卷纸模式」「无固定页长」选项，关闭驱动默认的A4/固定尺寸切纸逻辑，否则会出现固定长度切纸、多余空白的问题。
• 内容适配要求：小票内的图片、条码、二维码要设置和内容区等宽的固定尺寸，不要使用原生分辨率，避免撑宽页面导致高度计算错误；所有内容块不要保留之前A4逻辑中加的page-break-after="always"这类强制分页属性。

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