本文介绍如何在 xslt 3 中实现**运行时环境无关的哈希计算**，通过 `use-when` + `function-lookup()` 动态检测可用扩展函数（如 saxon-he 自定义 `iway:ifl` 或 java 反射调用），确保同一份样式表既能在生产环境（saxon-he）安全执行，也能在 altova xmlspy 等本地工具中无缝测试。
在企业级 XSLT 处理流程中，常需对 XML 片段（如 JSON 字符串、业务数据块）生成一致性哈希值用于去重、变更检测或缓存校验。然而，不同执行环境对扩展能力的支持存在显著差异：
- Saxon-HE（免费版）：仅支持 集成式扩展函数（integrated extension functions），即通过 Java API 显式注册的函数（如示例中的 iway:ifl），不支持反射式 Java 调用（java:* 命名空间）；
- Altova XMLSpy / Stylus Studio：通常不支持自定义 Saxon 扩展，但可加载外部 JAR 并通过 java:* 命名空间调用标准库（如 DigestUtils.md5Hex）；
- Saxon-PE/EE：两者均支持，但生产环境受限于许可证，无法启用反射调用。
直接硬编码分支逻辑（如 contains(system-property('xsl:vendor'), 'Saxon')）会导致 XSLT 在 Saxon-HE 下编译失败——因为 digest:* 函数虽未执行，但仍被解析器要求存在（违反“静态语义检查”规则）。正确解法是利用 XSLT 3 的 use-when 属性实现编译期条件编译：仅当目标函数在当前处理器中真实可用时，才将对应表达式纳入编译单元。
✅ 推荐方案：use-when + function-lookup() 动态适配
核心思想：用 function-lookup(QName, arity) 检测函数是否可调用，再通过 use-when 控制代码是否参与编译。以下为可直接复用的模板：
<xsl:stylesheet version="3.0"
xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
xmlns:iway="http://iway.company.com/saxon-extension"
xmlns:digest="java?path=jar:file:///C:/libs/commons-codec-1.13.jar!/"
exclude-result-prefixes="iway digest">
<xsl:output method="xml" indent="yes" omit-xml-declaration="yes"/>
<!-- 主处理模板 -->
<xsl:template match="/">
<Output>
<xsl:apply-templates mode="hash"/>
</Output>
</xsl:template>
<!-- 哈希计算模板 -->
<xsl:template match="SKU_SEG | row" mode="hash">
<xsl:variable name="textForHash" select="normalize-space(string(.))"/>
<!-- 方案1：优先使用 Saxon-HE 注册的 iway:ifl（SHA-1） -->
<xsl:variable name="hashVal" as="xs:string">
<xsl:value-of
select="iway:ifl(concat('_sha1(''', $textForHash, ''')'))"
use-when="exists(function-lookup(QName('http://iway.company.com/saxon-extension', 'ifl'), 1))"/>
</xsl:variable>
<!-- 方案2：备用使用 Java DigestUtils（MD5），仅当 iway:ifl 不可用时生效 -->
<xsl:variable name="hashValFallback" as="xs:string">
<xsl:value-of
select="digest:org.apache.commons.codec.digest.DigestUtils.md5Hex($textForHash)"
use-when="empty($hashVal) and exists(function-lookup(QName('java?path=jar:file:///C:/libs/commons-codec-1.13.jar!/', 'org.apache.commons.codec.digest.DigestUtils.md5Hex'), 1))"/>
</xsl:variable>
<Group>
<xsl:copy-of select="."/>
<HashValue>
<xsl:value-of select="$hashVal, $hashValFallback" />
</HashValue>
</Group>
</xsl:template>
</xsl:stylesheet>? 关键要点说明
- use-when 是编译期开关：表达式在 XSLT 编译阶段求值，若为 false，整条 <xsl:value-of> 会被完全忽略（不参与语法分析、类型检查或字节码生成），彻底规避 “函数不存在” 错误。
- function-lookup() 安全性：该函数返回 function(*)? 类型，exists(...) 仅检测其是否非空，不触发实际调用，无副作用。
-
路径与依赖管理：
- Saxon-HE 环境：确保 iway:ifl 已通过 processor.registerExtensionFunction() 注册（如问题中 Java 代码所示）；
- Altova 环境：需在工具设置中配置 commons-codec-1.13.jar 的类路径，并确认 java:* 命名空间支持（XMLSpy 2023+ 默认启用）；
- 注意：use-when 中的 QName 必须与函数注册时的命名空间和本地名严格一致（包括大小写）。
- 哈希算法选择：示例中 iway:ifl 封装 _sha1(...)，而 DigestUtils.md5Hex 提供 MD5。若需统一算法，建议在 Saxon-HE 中注册 SHA-256 等更安全的扩展函数，避免跨环境结果不一致。
⚠️ 注意事项与最佳实践
- Saxon-HE 版本要求：function-lookup() 需 Saxon-HE 10.0+（推荐 11.4+），旧版本不支持高阶函数，此方案不可用；
- 避免 system-property() 分支：contains(system-property('xsl:vendor'), 'Saxon') 仅能用于运行时判断，无法解决编译期函数缺失问题；
- 长文本处理：相比 HTTP 回调方案（受 URL 长度限制），本方案直接内存处理，无长度限制，适合大 JSON/XML 片段；
- 调试技巧：在开发时，可临时添加 <xsl:message>Using iway:ifl</xsl:message> 到 use-when 分支内，验证编译路径是否符合预期。
通过该方案，一份 XSLT 即可覆盖全部环境，消除维护多版本样式表的成本，真正实现“Write Once, Run Anywhere”的 XSLT 工程化目标。
