使用Apache FOP 1.1生成PDF时图片超出文档边界问题求助

嘿，我之前在使用Apache FOP 1.1生成带图片的PDF时，也碰到过图片超出文档边界的问题，给你几个亲测有效的解决办法：

这是最常用的方法，能让图片按比例自动缩放到指定的宽高范围内，不会拉伸变形。给你的fo:external-graphic加上这些属性：

<fo:external-graphic src="url('your-image-path.jpg')"
                     scale-to-fit="width height"
                     width="100%"
                     height="100%"
                     content-width="scale-down-to-fit"
                     content-height="scale-down-to-fit"/>

• scale-to-fit="width height" 指定图片要适配的维度
• content-width和content-height设为scale-down-to-fit，确保图片只会缩小不会被强制放大

如果你的PDF页面有固定的可用宽度（比如页面总宽度减去左右边距），可以给图片设置max-width，让宽于这个值的图片自动缩小：

<fo:external-graphic src="url('your-image-path.jpg')"
                     width="auto"
                     max-width="16cm"/> <!-- 替换成你页面的实际可用宽度，比如A4纸去掉2.5cm左右边距后是16cm -->

这里width="auto"会保持图片的原始宽高比，max-width则是图片能显示的最大宽度。

有时候问题出在页面本身的边距配置，或者图片所在的容器没有限制宽度。先确认你的页面模板边距是正确的：

<fo:simple-page-master master-name="A4-page"
                       page-width="21cm"
                       page-height="29.7cm"
                       margin-top="2cm"
                       margin-bottom="2cm"
                       margin-left="2.5cm"
                       margin-right="2.5cm">
  <fo:region-body margin="0"/>
</fo:simple-page-master>

同时确保图片所在的fo:block没有设置超出页面内容区域的宽度，比如不要给block设width="21cm"（这会忽略边距）。

如果只需要图片在宽于容器时缩小，不需要适配高度，可以用这个属性：

<fo:external-graphic src="url('your-image-path.jpg')"
                     content-width="scale-down"
                     width="100%"/>

这个设置会让图片宽度自适应容器，高度按比例调整，不会超出边界。

需要注意的是，Apache FOP 1.1对一些新属性支持有限，但上面这些方法都是1.1完全兼容的。如果还是有问题，可以检查下图片本身的尺寸是不是异常大，或者有没有嵌套的容器（比如fo:table-cell）限制了可用空间。

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