oasis xml catalog 通过映射替代解决实体解析问题：用本地文件替代远程dtd/xsd，统一管理多版本依赖，屏蔽不安全来源，并需在解析器中显式启用。
OASIS XML Catalog 是一种标准化机制，用于将 XML 文档中引用的外部实体（如 DTD、XSD、实体文件）重定向到本地或受控路径，从而解决网络不可达、加载缓慢、安全风险和环境不一致等问题。
它怎么解决实体解析问题
XML 解析器在遇到 ..> 或 xsi:schemaLocation 等声明时，会尝试按原始 URI（如 http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd）下载资源。若网络中断、URL 失效或策略禁止外连，解析就会失败。Catalog 通过“映射替代”绕过真实网络请求：
-
用本地文件代替远程 DTD/XSD：比如把公共标识符
-//W3C//DTD XHTML 1.0 Transitional//EN映射到项目内的dtds/xhtml1-transitional.dtd -
统一管理多版本依赖：用
<rewritesystem></rewritesystem>把所有https://api.example.com/v1/开头的 Schema 请求，自动重写为./schemas/v1/ - 屏蔽不安全或不可控来源：不解析任何未在 Catalog 中显式声明的外部 URI，避免意外加载恶意内容
Catalog 文件的核心映射方式
一个标准 Catalog（如 catalog.xml）使用 OASIS 命名空间，常见元素有：
-
<public></public>：匹配 DOCTYPE 中的 Public ID，例如publicId="-//W3C//DTD XHTML 1.0 Strict//EN"→uri="dtds/xhtml1-strict.dtd" -
<system></system>：精确匹配 SYSTEM 标识符（完整 URI），例如systemId="https://example.com/config.xsd"→uri="schemas/config.xsd" -
<rewritesystem></rewritesystem>：前缀匹配并重写，适合批量迁移，例如systemIdStartString="https://old-api.com/"→rewritePrefix="./schemas/old/"
让解析器真正用上 Catalog
仅写好 Catalog 文件还不够，必须在代码中显式启用：
-
Java（Apache XML Resolver）：设置
SAXParser或DocumentBuilder的EntityResolver属性为CatalogResolver("catalog.xml") -
.NET（XmlResolver）：创建自定义
XmlResolver子类，在ResolveUri中调用 Catalog 解析逻辑，再赋值给XmlDocument.XmlResolver -
命令行工具（如 xmllint）：用
--catalog=catalog.xml参数启用
为什么推荐用 Catalog 而不是硬编码路径
直接在 XML 里写 SYSTEM "local/schema.xsd" 看似简单，但会导致：
- 开发、测试、生产环境路径不一致，容易出错
- 多人协作时路径约定难统一
- 无法集中控制第三方 Schema 的版本升级
- 违反“配置与代码分离”原则，不利于 CI/CD 流水线验证
