当使用 getResourceAsStream() 加载 XSLT 文件时，XSLT 引用的 默认以应用服务器配置目录为基准路径；需通过 Source.setSystemId() 显式声明基础 URI，才能使相对路径解析指向 classpath 资源目录。
当使用 `getresourceasstream()` 加载 xslt 文件时，xslt 引用的 `
在基于 Java EE（如 Payara 6）的环境中使用 Apache FOP 进行 XSL-FO 转 PDF 时，若主样式表 example.xsl 存于 src/main/resources/（即运行时位于 WEB-INF/classes/），且其内部通过 <include href="dir/i18n.inc.xsl"></include> 引用同属资源目录的子文件，仅靠 getResourceAsStream() 是不够的——因为 Transformer 在解析 href 时会丢失上下文路径信息，默认回退至服务器工作目录（如 Payara 的 domains/domain1/config/），导致 FileNotFoundException。
✅ 正确做法是：为 StreamSource 显式设置 systemId，使其指向该 XSLT 文件在 classpath 中的完整 URI（如 jar:file:/app.jar!/example.xsl 或 file:/path/to/classes/example.xsl）。这将作为所有相对 href 的解析基准。
以下是修复后的关键代码段（适配 Java 17 + Payara 6 + Apache FOP）：
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
ClassLoader cl = MyClass.class.getClassLoader();
URL xslUrl = cl.getResource("example.xsl");
if (xslUrl == null) {
throw new IllegalStateException("XSL file 'example.xsl' not found in classpath");
}
String systemId = xslUrl.toURI().toString(); // ✅ 关键：提供绝对 URI 作为 base URI
InputStream styleSheetInput = cl.getResourceAsStream("example.xsl");
// 构建带 systemId 的 Source
StreamSource xslSource = new StreamSource(styleSheetInput);
xslSource.setSystemId(systemId); // ← 必须调用！
TransformerFactory factory = TransformerFactory.newInstance();
Transformer transformer = factory.newTransformer(xslSource); // 使用带 systemId 的 source
// 后续 FOP 流程保持不变
FopFactory fopFactory = FopFactory.newInstance(new File(".").toURI());
FOUserAgent foUserAgent = fopFactory.newFOUserAgent();
try (Fop fop = fopFactory.newFop(MimeConstants.MIME_PDF, foUserAgent, outputStream)) {
Source xmlSource = new StreamSource(datafile);
Result foResult = new SAXResult(fop.getDefaultHandler());
transformer.setParameter("versionParam", "2.0");
transformer.transform(xmlSource, foResult);
}⚠️ 注意事项：
立即学习“Java免费学习笔记（深入）”；
-
文件扩展名一致性：确保被包含文件（如
i18n.inc.xsl）与引用中的href完全一致（注意.xslvs.xslt）。某些构建工具（如 Maven Resources 插件）可能默认过滤非标准扩展名，导致i18n.inc.xslt未被打包进classes/目录。 -
资源路径结构：
dir/i18n.inc.xsl必须实际存在于src/main/resources/dir/i18n.inc.xsl，编译后路径为WEB-INF/classes/dir/i18n.inc.xsl。 -
URI 安全性：
xslUrl.toURI()在含空格或特殊字符的路径下可能抛URISyntaxException，生产环境建议包裹try-catch并降级处理（但通常 classpath 资源 URL 是安全的）。 -
替代方案（不推荐）：可改用
TransformerFactory.setURIResolver()自定义解析逻辑，但过度复杂；setSystemId是最轻量、标准且符合 XSLT 规范的解法。
总结：XSLT 的 href 解析依赖于 Source 的 systemId。忘记设置它，就等于让处理器“失明”——它只能凭猜测找文件。显式绑定 URI，是让资源路径真正“自描述”的关键一步。
