Saxon Transformer 11.3版本内存泄漏问题求助

核心排查方向 #

1. Configuration对象的线程安全与资源持有问题 #

Saxon 11对Configuration的线程安全模型做了调整，若多个Transformer共享同一Configuration实例，其内部缓存（如URIResolver、扩展函数缓存）在多线程场景下会堆积无法回收的对象：

• 为每个XSL样式表绑定独立的Configuration，避免全局共享。每个TransformerFactory对应专属Configuration，不要跨线程复用同一Configuration。
• 禁用非必要内部缓存：通过Configuration.setCacheSize(0)关闭样式表缓存，或针对DocumentBuilder等组件单独设置不缓存。

2. XSLT动态资源引用未释放 #

若XSL中使用document()函数、外部实体或自定义扩展函数，Saxon 11可能会持有这些资源的引用，导致内存泄漏：

• 每次转换完成后，调用transformer.clearParameters()清理参数上下文，并移除自定义URIResolver或ErrorListener的引用。
• 对于document()加载的外部资源，转换结束后显式释放关联的IO流（如文件流、网络流），避免资源被Saxon内部持有。

3. Transformer实例的生命周期管理问题 #

无论是复用还是新建Transformer，都要遵循Saxon 11的实例规则：

• 复用Transformer仅适用于单线程内重复调用：Saxon的Transformer实例本身线程不安全，跨线程共享会导致内部状态堆积，引发内存泄漏。
• 每次新建Transformer时，务必在使用完成后关闭TransformerFactory：TransformerFactoryImpl持有Configuration引用，未关闭会导致Configuration及关联资源无法被GC回收，调用factory.close()即可释放。

4. 内存快照分析（必做步骤） #

通过堆转储定位泄漏根源：

• 使用jmap生成堆转储文件：jmap -dump:format=b,file=heap.hprof <进程ID>
• 分析快照时重点查找net.sf.saxon.*包下的Configuration、StylesheetPackage、NodeInfo实例，检查Spring线程池、自定义缓存容器是否意外持有这些对象的引用。

修复示例代码 #

正确的TransformerFactory与Transformer管理方式 #

// 每个XSL对应独立的TransformerFactory，线程安全存储
private static final Map<String, TransformerFactory> factoryMap = new ConcurrentHashMap<>();

public Transformer getTransformer(String xslPath) throws TransformerException {
    return factoryMap.computeIfAbsent(xslPath, path -> {
        TransformerFactoryImpl saxonFactory = new TransformerFactoryImpl();
        Configuration config = saxonFactory.getConfiguration();
        // 关闭非必要缓存
        config.setCacheSize(0);
        config.getExtensionFunctionLibrary().clearCache();
        return saxonFactory;
    }).newTransformer(new StreamSource(new File(xslPath)));
}

// 应用关闭时清理所有Factory
@PreDestroy
public void shutdown() {
    factoryMap.values().forEach(factory -> {
        try {
            factory.close();
        } catch (Exception e) {
            // 记录日志
        }
    });
    factoryMap.clear();
}

额外注意事项 #

• 确保Saxon依赖版本完整：使用saxon-he或saxon-ee的完整包，避免混合不同版本依赖引发类加载泄漏。
• 升级到Saxon 11的最新补丁版本（如11.4），部分内存泄漏问题已在后续补丁中修复。

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