Saxon指定不存在的-catalog文件时静默运行，如何修复？

开发者阿泽

2026-5-20

问题分析与解决方案

这不是你的操作错误，而是xml-resolver和Saxon组合使用时的默认行为导致的：你指定了不存在的catalog文件，但xml-resolver的默认策略是静默忽略catalog加载失败的情况，继续执行后续的XSLT转换；而你设置的-warnings:fatal只对Saxon自身生成的警告生效，catalog加载属于xml-resolver的独立处理逻辑，不受这个参数管控，所以程序没有终止，只是输出了加载catalog的提示信息。

如何修复这个问题？

有两种可靠的方式可以让程序在catalog文件不存在时终止：

1. 强制xml-resolver严格处理catalog加载错误

通过添加JVM系统属性-Dxml.catalog.resolve=strict，告诉xml-resolver遇到无法加载的catalog资源时必须抛出异常，终止程序。修改后的命令如下：

$ java -Dxml.catalog.resolve=strict -cp saxon.jar:resolver.jar \
 net.sf.saxon.Transform \
 -t \
 -warnings:fatal \
 -catalog:this-file-is-absent.xml \
 -s:a.xml -xsl:a.xsl

这样当this-file-is-absent.xml不存在时，xml-resolver会直接抛出CatalogException，程序会立即停止，不会继续执行转换。

2. 提前在脚本中检查文件是否存在

如果你希望在启动Saxon之前就拦截错误，可以在shell脚本中加入文件存在性检查：

#!/bin/bash
CATALOG_FILE="this-file-is-absent.xml"

# 检查catalog文件是否存在
if [ ! -f "$CATALOG_FILE" ]; then
    echo "Fatal error: Catalog file '$CATALOG_FILE' does not exist."
    exit 1
fi

# 执行Saxon转换
java -cp saxon.jar:resolver.jar \
 net.sf.saxon.Transform \
 -t \
 -warnings:fatal \
 -catalog:"$CATALOG_FILE" \
 -s:a.xml -xsl:a.xsl

这种方式能在启动转换流程前就终止程序，避免不必要的资源消耗。