XML解析器在解析带有DTD或Schema校验的文档时，需要先加载对应的校验文件，如果无法找到这些文件就会抛出解析异常，这类问题通常和路径配置或者解析器的资源定位逻辑有关。
常见的路径问题及排查方法
相对路径基准错误
很多开发者会使用相对路径指定DTD或Schema的位置，但是XML解析器的相对路径基准不是当前Java类或者XML文件所在的目录，而是解析时传入的输入流的基准位置，或者是JVM的启动目录。如果相对路径的基准理解错误，就会出现文件找不到的情况。
比如下面的XML文档中，Schema路径是相对路径：
<?xml version="1.0" encoding="UTF-8"?>
<user xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:noNamespaceSchemaLocation="schema/user.xsd">
<name>张三</name>
<age>20</age>
</user>
如果解析时使用的输入流是从类路径加载的，那么xsi:noNamespaceSchemaLocation的基准就是类路径的根目录，需要把user.xsd放在类路径下的schema目录中才能正确加载。
绝对路径配置不当
使用绝对路径时，要注意不同操作系统的路径分隔符差异，Windows系统使用反斜杠，而Linux和macOS使用正斜杠/。如果硬编码了Windows风格的路径，在Linux环境下运行就会出现文件找不到的问题。另外，绝对路径如果指向了不存在的目录，或者没有对应的文件访问权限，也会导致解析失败。
网络路径无法访问
很多公开的DTD或Schema会使用网络URL作为位置，比如<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">，如果运行环境没有网络，或者对应的网络地址无法访问，解析器就无法下载校验文件，从而抛出异常。
使用catalog解析器解决路径问题
catalog解析器可以通过配置映射规则，把XML中指定的DTD或Schema路径映射到本地文件路径，不需要修改XML文档本身的路径配置，非常适合解决网络路径不可访问或者路径基准混乱的问题。
catalog文件配置
catalog文件是XML格式的配置文件，用来定义路径映射规则，常见的映射指令有rewriteSystem用来映射DTD的系统标识符，rewriteURI用来映射Schema的URI。
下面是一个catalog文件的示例，把网络上的XHTML DTD映射到本地文件，把相对路径的user.xsd映射到类路径下的指定位置：
<?xml version="1.0" encoding="UTF-8"?>
<catalog xmlns="urn:oasis:names:tc:entity:xmlns:xml:catalog">
<!-- 映射网络DTD到本地文件 -->
<rewriteSystem systemIdStartString="http://www.w3.org/TR/xhtml1/DTD/"
rewritePrefix="file:///usr/local/dtd/">
<!-- 映射Schema相对路径到类路径 -->
<rewriteURI uriStartString="schema/"
rewritePrefix="classpath:schema/">
</catalog>
在解析器中集成catalog解析器
以Java的SAX解析器为例，需要先把catalog解析器注册到XML解析器的实体解析器中，以下是完整的示例代码：
import org.xml.sax.EntityResolver;
import org.xml.sax.InputSource;
import org.xml.sax.SAXException;
import org.xml.sax.XMLReader;
import org.xml.sax.helpers.XMLReaderFactory;
import javax.xml.parsers.SAXParser;
import javax.xml.parsers.SAXParserFactory;
import java.io.File;
import java.io.FileInputStream;
import java.io.IOException;
public class XmlParseDemo {
public static void main(String[] args) throws Exception {
// 创建SAXParserFactory实例
SAXParserFactory factory = SAXParserFactoryFactory.newInstance();
// 开启校验
factory.setValidating(true);
factory.setNamespaceAware(true);
// 创建SAXParser
SAXParser saxParser = factory.newSAXParser();
XMLReader xmlReader = saxParser.getXMLReader();
// 创建catalog解析器，指定catalog文件路径
EntityResolver catalogResolver = new org.apache.xml.resolver.tools.CatalogResolver();
((org.apache.xml.resolver.tools.CatalogResolver) catalogResolver).getCatalog().parseCatalog("catalog.xml");
// 设置实体解析器为catalog解析器
xmlReader.setEntityResolver(catalogResolver);
// 解析XML文件
File xmlFile = new File("test.xml");
xmlReader.parse(new InputSource(new FileInputStream(xmlFile)));
System.out.println("XML解析成功");
}
}
上面的代码使用了Apache的xml-resolver库提供的CatalogResolver实现，需要在项目中引入对应的依赖。如果是Maven项目，可以添加以下依赖：
<dependency>
<groupId>xml-resolver</groupId>
<artifactId>xml-resolver</artifactId>
<version>1.2</version>
</dependency>
路径配置的最佳实践
- 优先使用类路径相对路径，而不是文件系统的相对路径，避免不同环境下基准目录不一致的问题
- 对于公开的DTD或Schema，尽量使用catalog解析器映射到本地副本，避免依赖网络环境
- 不要在代码中硬编码绝对路径，可以通过配置文件或者环境变量来指定校验文件的根目录
- 解析前先检查校验文件是否存在，并且有足够的读取权限，提前抛出明确的错误信息
常见问题排查步骤
当遇到XML解析器找不到DTD或Schema文件的问题时，可以按照以下步骤排查：
- 查看解析异常的具体信息，确认是系统标识符找不到还是URI找不到，对应的路径是什么
- 检查对应的路径下是否存在目标校验文件，路径分隔符是否符合当前操作系统的要求
- 如果是网络路径，检查当前环境是否可以访问该网络地址，或者是否需要配置代理
- 尝试使用catalog解析器配置映射规则，把原始路径映射到本地可访问的文件路径
- 如果是相对路径，确认解析器的相对路径基准，调整校验文件的存放位置或者路径配置
XML解析DTDSchemacatalog解析器路径配置修改时间：2026-07-02 18:39:43