如何配置WSO2 ESB使用Saxon 9.8 HE运行XSLT 3.0版的XSLT Mediator

出现net.sf.saxon.trans.LicenseException: Requested feature (XSLT 3.0) requires Saxon-PE报错，本质是两层问题叠加导致的：

• 能力边界问题：Saxon 9.8 HE作为开源免费版本，本身就不覆盖你代码中用到的全部XSLT 3.0特性。官方在9.8版本线里，把json-to-xml()高阶函数、XPath箭头操作符=>这类功能划入了Saxon-PE/EE商业授权的范围，哪怕你正确替换了HE版的jar包，只要触发这些特性，就会被内置的授权校验逻辑直接拦截。
• 类加载冲突问题：多数人替换Saxon jar时没有清理ESB自带的旧版本Saxon依赖，导致WSO2 ESB没有真正加载你放的HE版Saxon，仍在使用ESB自带的商业版Saxon类路径，进一步放大了授权报错的概率。

• 完成Saxon 9.8 HE的替换与类加载隔离
  • 先到WSO2 ESB的repository/components/lib目录下，移除所有存量的Saxon相关jar包（包括旧版本的saxon9he.jar、ESB默认捆绑的saxon-pe/ee相关依赖包），彻底解决多版本共存带来的类加载优先级冲突。
  • 将单独获取的9.8 HE版本saxon9he.jar放入上述lib目录，重启ESB让类加载器完成新依赖的扫描。
  • 打开repository/conf/synapse.properties配置文件，新增配置项synapse.xslt.transformer.factory.impl = net.sf.saxon.TransformerFactoryImpl，强制XSLT Mediator直接加载我们放入的HE版Saxon工厂类，绕过ESB默认的内置XSLT引擎选择逻辑。
• 调整XSLT代码适配HE版本的能力范围
  • 把代码中原有的version="3.0"声明替换为version="2.0"，避免Saxon加载时检测到XSLT 3.0版本标识，直接触发授权校验逻辑。
  • 不要在XSLT内部直接调用json-to-xml()方法：在XSLT Mediator的前置流程里，增加WSO2内置的JSONToXML Mediator，把消息载荷中//return节点下的JSON内容先转换为标准XML结构后，再传入XSLT做后续节点取值。
  • 把原代码里用XPath箭头操作符写的逻辑，改成HE版Saxon 9.8支持的标准XPath 2.0语法完成节点选取，不需要依赖额外的高阶函数能力。
• 执行链路验证
  • 配置完成重启ESB后，触发包含调整后XSLT Mediator的业务流程，观察服务日志里实际加载的Saxon类路径，确认不再触发LicenseException，且XSLT节点取值逻辑能正常返回预期结果。

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