XSL-FO图片重叠问题：Apache FOP生成AFP正常PDF失效

一、PDF重叠失效及SVG图片不显示的原因 #

1. 绝对定位上下文差异：Apache FOP对AFP和PDF的表格单元格内绝对定位元素的渲染逻辑不同。AFP引擎允许直接在表格单元格内识别绝对定位的块容器作为独立层，但PDF渲染时，表格单元格的块格式化上下文会限制绝对定位元素的参照系，导致元素无法按预期重叠。
2. SVG渲染支持问题：使用<fo:instream-foreign-object>嵌入SVG时，若SVG未声明正确的命名空间、缺少viewBox属性，或内部图片引用格式不符合FOP的PDF渲染规范，会导致SVG内容无法被解析显示。

二、共用XSL模板的修复方案 #

1. 调整定位容器结构 #

在表格单元格内先添加一个相对定位的块容器，将两张图片的绝对定位块嵌套其中，确保两者的定位参照系一致：

<fo:table-cell>
  <!-- 相对定位容器作为定位基准 -->
  <fo:block position="relative" width="100%" height="100%">
    <!-- 底层TIFF图片 -->
    <fo:block absolute-position="absolute" top="0" left="0" width="100%" height="100%">
      <fo:external-graphic src="url('image.tiff')" width="100%" height="100%"/>
    </fo:block>
    <!-- 上层SVG图片容器 -->
    <fo:block absolute-position="absolute" top="0" left="0" width="100%" height="100%">
      <fo:instream-foreign-object>
        <!-- 确保SVG命名空间和viewBox正确 -->
        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 600 400" width="100%" height="100%">
          <image href="image.jpg" width="600" height="400"/>
        </svg>
      </fo:instream-foreign-object>
    </fo:block>
  </fo:block>
</fo:table-cell>

2. 修复SVG显示问题 #

• 必须为SVG声明标准命名空间：xmlns="http://www.w3.org/2000/svg"
• 添加viewBox属性定义SVG的坐标系统，确保缩放适配容器
• SVG内部图片引用使用href属性（旧版SVG可使用xlink:href，需同时声明xmlns:xlink="http://www.w3.org/1999/xlink"）

三、无法共用模板时的PDF专属解决方案 #

1. 替代定位方案 #

改用负边距实现图片重叠（适合简单场景）：

<fo:table-cell>
  <fo:block>
    <fo:external-graphic src="url('image.tiff')" width="100%" height="100%"/>
    <fo:external-graphic src="url('image.jpg')" width="100%" height="100%" margin-top="-100%"/>
  </fo:block>
</fo:table-cell>

2. 预处理图片合并 #

使用图片处理工具（如ImageMagick）预先将TIFF和JPG合并为一张图片，直接引用合并后的文件：

convert image.tiff image.jpg -composite merged.jpg

然后在XSL中直接引用merged.jpg，避免定位和SVG的兼容性问题。

3. 替换SVG为PDF片段 #

将SVG转换为独立的PDF文件，再通过<fo:external-graphic>引用，绕过fo:instream-foreign-object的PDF渲染限制：

<fo:table-cell>
  <fo:block position="relative" width="100%" height="100%">
    <fo:block absolute-position="absolute" top="0" left="0">
      <fo:external-graphic src="url('image.tiff')" width="100%" height="100%"/>
    </fo:block>
    <fo:block absolute-position="absolute" top="0" left="0">
      <fo:external-graphic src="url('svg-converted.pdf')" width="100%" height="100%"/>
    </fo:block>
  </fo:block>
</fo:table-cell>

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