无法在fo:external-graphic的src属性中访问xsl:param变量求助

核心问题排查方向 #

• 参数传递有效性：首先要确认$IMG/$IMGLogo参数是否真的获取到了完整的图片路径。如果URL中的参数包含特殊字符（如空格、&）未转义，服务器端可能会截断参数值；或是XSLT处理器未被正确传入该参数，导致参数为空，最终生成的src属性无效。
• file URI格式错误：你当前使用的file:///{$IMG}会导致路径格式异常。例如若$IMG值为/{PATH}/test.jpg，拼接后会变成file:////{PATH}/test.jpg（四个斜杠），不符合Unix/Linux系统下file:///绝对路径的标准格式（三个斜杠后接路径）。
• 参数默认值缺失：你的<xsl:param>未设置默认值，若参数未成功传递，src会变成file:///，必然无法加载图片。
• FO处理器限制：不同FO处理器（如Apache FOP、RenderX XEP）对本地文件加载有不同规则，部分处理器需要配置baseDir、开启本地文件访问权限，或是对URI的特殊字符转义有严格要求。

修复步骤 #

1. 验证参数值：在XSLT中临时添加<xsl:value-of select="$IMG"/>，输出参数实际值，确认是否与URL中的/{PATH}/test.jpg完全一致，排查是否存在截断、转义丢失问题。
2. 修正URI格式：将src属性中的路径拼接改为标准格式：

   <fo:external-graphic src="file://{$IMG}"/>
   

   若$IMG是Unix绝对路径（如/opt/images/test.jpg），拼接后会生成正确的file:///opt/images/test.jpg。
3. 添加参数默认值：给参数设置默认路径，方便测试排查：

   <xsl:param name="IMG" select="'/default/images/test.jpg'"></xsl:param>
   

4. 转义特殊字符：若路径包含空格、#、&等特殊字符，使用encode-uri()函数转义：

   <fo:external-graphic src="file://{encode-uri($IMG, true())}"/>
   

5. 检查FO处理器配置：以Apache FOP为例，需确保未禁用本地文件加载，可通过设置baseDir指定图片根目录，或在配置中开启相关权限。

修正后示例代码（场景一） #

<?xml version="1.0" encoding="UTF-8"?>
<!-- 省略其他命名空间与模板代码 -->
<xsl:param name="IMG" select="'/default/path/test.jpg'"></xsl:param>

<xsl:template match="fooString">
 <fo:root xmlns:fo="http://www.w3.org/1999/XSL/Format">
   <!-- 其他FO布局内容 -->
   <fo:inline>
     <fo:external-graphic src="file://{encode-uri($IMG, true())}"/>
   </fo:inline>
   <!-- 其他FO布局内容 -->
 </fo:root>
</xsl:template>

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