<think>好的，我需要分析用户在Jenkins构建后遇到的两个异常：org.apache.poi.openxml4j.exceptions.NotOfficeXmlFileException和cn.hutool.extra.template.TemplateEngine的ServiceConfigurationError。首先，我得先分别理解这两个异常的含义以及常见的原因。
第一个异常是NotOfficeXmlFileException，属于Apache POI库的异常。通常这个错误发生在尝试用POI打开一个不符合Office Open XML格式的文件时。可能的原因包括文件
损坏、文件扩展名与实际格式不符，或者在读取文件时出现了
问题，比如编码错误或者文件权限
问题。此外，用户之前提到过SpringBoot项目中的
资源文件损坏问题，这可能与构建过程中文件的处理方式有关。例如，在
Maven或Gradle构建时，
资源文件可能被错误地过滤或转换，
导致文件
损坏。这时候需要检查构建配置，确保
资源文件不被修改。另外，内存不足也可能
导致文件读取异常，特别是在处理大文件时，需要考虑调整JVM的内存参数，如-Xmx和-Xms。
第二个异常是TemplateEngine的ServiceConfigurationError，来自Hutool工具库。这通常发生在服务加载机制无法找到合适的
模板引擎实现时。可能的原因包括类路径中缺少相关的
模板引擎依赖，比如用户可能没有引入Beetl、Velocity或Thymeleaf等引擎的实现。此外，如果构建过程中依赖项没有正确
打包，比如在Jenkins环境中缺少某些jar包，或者依赖冲突
导致某些类无法加载，也会引发这个
问题。还有可能是安全策略或模块化系统（如
Java 9+的模块化）限制了服务加载，需要检查相关的配置。
接下来，我需要结合用户提供的引用内容来寻找解决方案。引用[1]提到
资源文件损坏的
问题，可能和构建时的处理有关，需要确保
资源文件不被过滤。引用[2]中的修复方式是通过设置安全处理特性，这可能与XML解析相关，但不确定是否适用于当前
问题。引用[3]提到内存
问题，调整JVM内存参数可能对处理大文件有帮助。
针对第一个异常，可能的解决步骤包括：检查构建配置中的资源过滤，确保
docx文件不被处理；验证文件是否实际
损坏；增加JVM内存参数；检查文件路径是否正确，尤其是在Jenkins的工作空间中文件是否存在。对于第二个异常，则需要检查项目的依赖，确保引入了需要的
模板引擎实现；确认构建过程中依赖正确
打包；检查类路径是否有冲突；或者尝试明确指定
模板引擎实现。
此外，Jenkins的环境可能与本地环境不同，比如文件路径、权限、依赖版本等，需要确认这些因素是否
导致问题。可能需要查看Jenkins的构建日志，确认
资源文件是否正确复制，依赖是否完整下载，是否存在权限
问题导致文件无法正确读取。
总结来说，两个异常可能分别由文件
损坏或格式错误、依赖缺失或配置
问题引起。需要逐步排查构建配置、依赖管理、资源处理和运行环境设置等方面。</think>### Jenkins构建后出现
docxToPdf异常和TemplateEngine配置错误的详细分析
---
#### **一、`NotOfficeXmlFileException`异常分析**
1. **根本原因**
- **文件
损坏或格式错误**：Jenkins构建过程中可能因资源过滤
导致`.
docx`文件被修改，例如
Maven的`resources`插件错误配置[^1]。
- **路径或权限
问题**：Jenkins工作空间路径与本地环境不一致，或构建后文件未正确复制到目标目录。
- **内存不足**：处理大文件时若JVM堆内存不足，可能
导致文件读取异常[^3]。
2. **解决方案**
- **检查构建配置**：在`pom.xml`或`build.gradle`中排除对`.
docx`文件的过滤：
```xml
<!--
Maven示例 -->
<resources>
<resource>
<directory>src/main/resources</directory>
<filtering>false</filtering> <!-- 关闭过滤 -->
</resource>
</resources>
```
- **验证文件完整性**：在Jenkins构建后增加文件校验步骤，例如通过MD5比对本地与服务器文件。
- **调整JVM内存**：在Jenkins启动参数中增加`-Xmx2048m -Xms512m`以提升堆内存。
- **显式指定文件类型**：使用`FileUtil.getInputStream()`确保文件流正确读取：
```
java
File file = new File("path/to/file.
docx");
try (InputStream is = FileUtil.getInputStream(file)) {
XWPFDocument doc = new XWPFDocument(is);
}
```
---
#### **二、`TemplateEngine ServiceConfigurationError`异常分析**
1. **根本原因**
- **依赖缺失**：Hutool的`TemplateEngine`需要至少一个
模板引擎（如Beetl、Velocity）的依赖，但构建时未正确引入。
- **类加载冲突**：Jenkins环境中存在多个版本的依赖，
导致`ServiceLoader`无法加载实现类。
- **安全策略限制**：
Java安全配置阻止了服务发现机制（类似XML解析的安全处理
问题[^2]）。
2. **解决方案**
- **添加必要依赖**：在项目中明确引入
模板引擎实现（以Beetl为例）：
```xml
<!--
Maven示例 -->
<dependency>
<groupId>com.ibeetl</groupId>
<artifactId>beetl</artifactId>
<version>3.12.0.RELEASE</version>
</dependency>
```
- **检查依赖树**：通过`mvn dependency:tree`或`gradle dependencies`排查版本冲突。
- **显式指定引擎**：强制使用特定引擎避免自动发现失败：
```
java
TemplateConfig config = new TemplateConfig("templates", TemplateEngine.BEETL);
TemplateEngine engine = TemplateUtil.createEngine(config);
```
- **调整模块化配置**（
Java 9+）：在`module-info.
java`中添加`provides`声明：
```
java
provides cn.hutool.extra.template.TemplateEngine with cn.hutool.extra.template.engine.beetl.BeetlEngine;
```
---
#### **三、Jenkins环境特殊注意事项**
1. **工作空间路径
问题**
- 使用绝对路径或通过环境变量动态获取路径：
```
java
String workspacePath = System.getenv("JENKINS_HOME") + "/workspace/project";
```
2. **构建节点配置**
- 确保构建节点与本地环境的JDK版本、操作系统一致。
3. **日志调试**
- 在Jenkins构建脚本中增加调试输出：
```bash
echo "当前工作目录: $(pwd)"
ls -lR target/classes/
```
---
§§
1. 如何排查Jenkins构建中的
资源文件路径
问题？
2. Hutool的`TemplateEngine`支持哪些
模板引擎？如何选择最优实现？
3. 如何通过Jenkins Pipeline优化
Java应用的内存配置？
本文讲述了在编程中遇到读取用户协议时，由于mvn打包压缩导致docx文件损坏的问题，以及如何通过在pom.xml中配置`maven-resources-plugin`来确保docx等文档文件在打包时不被压缩。
扫一扫
4310
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
