HTML转PDF：如何查询XSLT-FO输出节点的属性值？

针对你遇到的问题——想让不含子表格的行不拆分但设置无效，还看不到FO节点的属性信息，我整理了几个靠谱的排查方法，亲测好用：

1. 直接生成并查看完整的FO文档 #

这是最直观的方式，毕竟看不到生成的FO，调样式全靠猜。你可以用FOP命令直接输出FO文件，而不是直接转PDF：

fop -xml 你的输入XML文件 -xsl 你的XSLT样式表 -foout 输出的FO文件名.fo

打开生成的.fo文件，找到对应的<fo:table-row>节点，直接查看它的属性（比如keep-together.within-page）有没有正确设置。比如你要的目标行应该有类似这样的属性：

<fo:table-row keep-together.within-page="always">
  <!-- 行内容 -->
</fo:table-row>

如果这里没看到这个属性，说明你的XSLT匹配逻辑有问题，没把属性加到正确的行上；如果有，但还是拆分了，那可能是父节点（比如<fo:table-body>或<fo:table>）的属性覆盖了它。

2. 调高FOP的日志级别到DEBUG #

你之前的日志没具体内容，大概率是日志级别太低了。把FOP的日志调到DEBUG，就能看到每个FO节点的详细属性信息：

• 命令行方式：在调用FOP的时候加-l debug参数，比如：

fop -xml input.xml -xsl stylesheet.xsl -pdf output.pdf -l debug

• 配置文件方式：修改FOP的conf/fop.xconf，找到<logger name="org.apache.fop">的配置，把level改成DEBUG：

<logger name="org.apache.fop">
  <level value="DEBUG"/>
  <appender-ref ref="Console"/>
</logger>

这样日志里会打印每个FO节点的属性细节，比如哪些行的keep-together属性是啥，有没有被继承或覆盖。

3. 在XSLT里加调试输出 #

如果不想生成整个FO文件，可以在XSLT处理行的时候，用<xsl:message>输出关键信息，确认你的逻辑是否正确匹配了目标行，属性是否正确设置：

<!-- 匹配不含子表格的行 -->
<xsl:template match="tr[not(.//table)]">
  <fo:table-row keep-together.within-page="always">
    <!-- 处理行内单元格的逻辑 -->
    <xsl:apply-templates select="td"/>
  </fo:table-row>
  <!-- 调试输出：确认这个行被匹配到，属性已设置 -->
  <xsl:message>✅ 处理了一个不含子表格的行，已设置keep-together.within-page="always"</xsl:message>
  <!-- 可选：输出当前节点的所有属性，排查继承问题 -->
  <xsl:message>当前行的父节点属性：<xsl:value-of select="../@*"/></xsl:message>
</xsl:template>

运行XSLT转换时，控制台会打印这些调试信息，帮你确认目标行是否被正确处理。

额外提示：排查属性覆盖问题 #

如果FO里已经有keep-together.within-page="always"但还是拆分了，要检查父节点的属性：

• 比如<fo:table-body>或<fo:table>有没有设置keep-together.within-column="auto"或者其他可能覆盖行属性的配置；
• 嵌套表格的行如果被错误继承了父行的keep-together属性，也会导致混乱，所以要确保你的XSLT只给不含子表格的行加属性，匹配条件tr[not(.//table)]要准确，别把嵌套表格的行也包含进去。

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