Saxon HE 10.3已引入ICU4J却不生效，如何完成注册配置？

Saxon HE 本身支持通过ICU4J实现本地化的日期时间格式化，但该能力不会通过classpath扫描自动激活，仅把ICU4J加入classpath是无法触发生效的，必须手动完成配置，具体操作如下：

前置依赖校验 #

• 确认引入完整版本的ICU4J 依赖，对应maven坐标为com.ibm.icu:icu4j，推荐搭配68.2版本使用，该版本和Saxon HE 10.3 经过兼容性验证，不要使用拆分的精简ICU组件包，否则会出现类加载失败的问题。
• 确认你的saxon-he-10.3.jar 是完整官方包，包含可选的ICU对接类net.sf.saxon.option.icu.ICUDateTimeFormatter——该类从Saxon 10.0 开始被打包到HE核心jar中，无需额外下载插件包。

分场景配置激活 #

Java 嵌入式调用场景 #

在代码中初始化Saxon配置时，显式指定使用ICU作为日期时间格式化器，不要直接使用默认的无参构造方法创建TransformerFactory：

// 初始化Saxon核心配置
Configuration saxonConfig = Configuration.newConfiguration();
// 手动指定ICU实现的日期格式化器
saxonConfig.setDateTimeFormatter(new ICUDateTimeFormatter());
// 基于自定义配置构建转换器工厂
TransformerFactory factory = new TransformerFactoryImpl(saxonConfig);

完成配置后，你在样式表中编写的format-dateTime(current-dateTime(), '[h1]:[m01] [P] on [MNn] [D].', 'de', 'AD', 'DE') 逻辑，就会自动调用ICU4J的本地化规则完成德语区的日期渲染。

命令行执行转换场景 #

如果通过命令行调用Saxon执行转换逻辑，不需要修改代码，只需在JVM启动参数中指定对应的格式化器实现即可，注意根据操作系统调整classpath的分隔符（Linux/macOS用:，Windows用;）：

java \
  -cp "saxon-he-10.3.jar:icu4j-68.2.jar" \
  -Dhttp://saxon.sf.net/feature/dateTimeFormatter=net.sf.saxon.option.icu.ICUDateTimeFormatter \
  net.sf.saxon.Transform -s:input.xml -xsl:your-stylesheet.xsl

常见配置坑排查 #

• 类名适配版本：不要照搬Saxon 9.x 的老教程——Saxon 9.x 的HE版本不支持ICU对接，对应的ICU格式化类是com.saxonica.config.ICUDateTimeFormatter，属于商业版PE/EE专属类，HE版本不存在该类，强行配置会直接抛出类找不到的异常。
• 不要依赖自动发现机制：Saxon HE 10.3 的ICU对接没有实现SPI服务自动加载逻辑，只要没有显式指定格式化器实现，哪怕两个依赖都在classpath里，Saxon也会默认走JDK内置的格式化逻辑，完全不会加载ICU4J的类。
• 格式化逻辑校验：你编写的format-dateTime参数本身是符合XPath 3.1规范的，只要激活了ICU格式化器，传入的语言、日历、地区参数就会正常生效，不需要修改样式表代码。

内容的提问来源于stack exchange，提问作者Dave The Dane