Springboot使用maven编译报juh-3.2.1.jar缺失

Springboot使用maven编译报juh-3.2.1.jar缺失

java.io.FileNotFoundException: D:\code\java\src\main\resources\META-INF\resources\WEB-INF\lib\juh-3.2.1.jar

你遇到了java.io.FileNotFoundException异常，核心是无法找到指定路径下的juh-3.2.1.jar文件（异常信息末尾文件名被截断，完整应为juh-3.2.1.jar），且该文件的预期路径D:\code\java\src\main\resources\META-INF\resources\WEB-INF\lib\存在明显配置异常，下面为你全面分析根因、分步解决及关键注意事项。

异常核心解读

直接问题：指定路径下不存在juh-3.2.1.jar文件（可能缺失、路径错误、文件名拼写错误）；

关键隐患：src/main/resources/META-INF/resources/WEB-INF/lib/ 不是 Java 项目（尤其是 Spring Boot/Jeecg/MiniDao 项目）存放依赖 jar 包的正确路径，该路径违背了 Maven/Gradle 项目的资源目录规范，是导致异常的核心根源之一。

补充说明：juh-3.2.1.jar通常是LibreOffice/OpenOffice 的 Java 操作组件（用于文档解析、转换等功能），常见于 Jeecg 等项目的办公文档处理模块。

根因全面分析

依赖 jar 包缺失或未正确引入

项目未添加juh相关依赖（Maven/Gradle 依赖配置缺失），导致目标路径下无该 jar 包；

即使手动下载了juh-3.2.1.jar，也放置在了错误的目录，未被项目识别和加载。

资源目录路径配置错误（核心）

Maven/Gradle 项目中，src/main/resources是资源文件目录（用于存放application.yml、配置文件、静态资源等），而非依赖 jar 包目录；

依赖 jar 包的正确管理方式：由 Maven/Gradle 统一管理，存放于项目本地仓库（~/.m2/repository/），编译打包时自动引入，无需手动放置到WEB-INF/lib；

手动在src/main/resources下创建META-INF/resources/WEB-INF/lib/目录放置 jar 包，既不符合项目规范，也无法被类加载器正确加载，还会导致打包后路径混乱。

文件名截断或拼写错误

异常信息中文件名末尾被截断（juh-3.2.1.ja），可能是：文件实际名为juh-3.2.1.jar但手动输入时遗漏后缀，或文件被误重命名，或路径过长导致系统截断文件名。

权限不足或文件被占用

目标目录（D:\code\java\src\main\resources...）无读写权限，无法放置或读取 jar 包；

juh-3.2.1.jar被其他程序（如 IDE、解压工具）占用，导致项目无法访问。

分步解决方案

方案 1：通过 Maven 正确引入juh依赖（推荐，符合项目规范）

核心思路：放弃手动放置 jar 包，通过 Maven 配置统一管理依赖，让 Maven 自动下载、加载juh-3.2.1.jar，避免路径配置错误。

步骤 1：确认juh依赖的 Maven 坐标

juh依赖通常有两种获取方式，按需选择：

方式 1：公共仓库直接引入（若存在）在项目pom.xml的中添加如下配置：

org.openoffice juh 3.2.1

方式 2：本地 jar 包安装到 Maven 仓库（公共仓库无该版本时，核心解决手动 jar 包无法被项目识别的问题）

手动下载完整的juh-3.2.1.jar文件（确保文件名完整，无截断）；

打开命令提示符（CMD），执行 Maven 安装命令（替换对应路径）：

# 核心命令：install:install-file
mvn install:install-file -Dfile=D:\project\juh-3.2.1.jar -DgroupId=org.openoffice -DartifactId=juh -Dversion=3.2.1 -Dpackaging=jar

命令参数说明：

-Dfile：本地juh-3.2.1.jar的完整路径；

-DgroupId/-DartifactId/-Dversion：自定义 Maven 坐标（需与后续 pom.xml 配置一致）；

安装成功后，在pom.xml中添加与上述坐标一致的依赖（同方式 1 的配置）。

步骤 2：刷新 Maven 依赖，让项目加载该 jar 包

回到 IDEA，右键项目根目录（或pom.xml）→ 「Maven → Reload Project」；

等待依赖刷新完成，查看「External Libraries」中是否出现juh-3.2.1依赖，出现则表示加载成功；

若刷新失败，检查 Maven 配置是否正常（IDEA 中 Maven 的用户设置文件是否配置正确，本地仓库路径是否可访问）。

步骤 3：删除错误的手动目录（清理无效配置）

删除src/main/resources下的META-INF/resources/WEB-INF/lib/目录（该目录无任何实际作用，反而会导致路径混乱），避免项目后续加载时出现冲突。

方案 2：若必须手动放置 jar 包（不推荐，仅应急使用）

若因特殊原因无法通过 Maven 管理，需手动放置 jar 包，需遵循正确的目录规范：

步骤 1：选择正确的手动 jar 包目录

Spring Boot 内嵌 Tomcat 项目（jar 包部署）：无需手动放置WEB-INF/lib，可将juh-3.2.1.jar放置在src/main/resources/lib/（手动创建lib目录），并在pom.xml中配置该目录为依赖目录：

xml
org.openoffice juh 3.2.1 system ${project.basedir}/src/main/resources/lib/juh-3.2.1.jar

外置 Tomcat 项目（war 包部署）：将juh-3.2.1.jar放置在外置 Tomcat 的lib目录（如D:\project\apache-tomcat\lib\），或打包后放置在war包/WEB-INF/lib/目录，而非项目的src/main/resources下。

步骤 2：确保文件完整且路径正确

验证juh-3.2.1.jar文件完整性：双击打开 jar 包，确认内部有META-INF/MANIFEST.MF文件，无损坏；

核对文件路径：确保 jar 包的实际路径与项目代码中引用的路径一致，避免代码中硬编码错误路径（如拼写错误、目录层级错误）。

方案 3：解决权限与文件占用问题

权限修复：

右键项目目录D:\code\java\ → 「属性 → 安全」；

选择当前登录用户，勾选「完全控制、修改、读取和执行」等权限，点击「应用 → 确定」；

若仍无权限，可右键 jar 包 → 「属性 → 解除锁定」（部分从外网下载的文件会被系统锁定）。

解除文件占用：

打开「任务管理器 → 详细信息」，结束占用该 jar 包的进程（如java.exe、idea64.exe、WinRAR.exe等）；

重启 IDEA 和项目，重新放置或加载 jar 包。

方案 4：排查代码中的硬编码路径问题

异常可能是代码中硬编码了错误路径导致，需排查并修改：

在 IDEA 中，使用「Ctrl+Shift+F」全局搜索juh-3.2.1或WEB-INF/lib/juh，找到代码中引用该 jar 包的位置；

检查是否硬编码了路径D:\code\java\src\main\resources\META-INF\resources\WEB-INF\lib\，将其修改为正确路径：

推荐：使用项目相对路径或配置文件配置路径（如在application.yml中配置juh.jar.path=classpath:lib/juh-3.2.1.jar）；

避免：硬编码绝对路径（容易导致环境迁移后路径失效）。

关键注意事项与预防措施

遵循 Maven 项目规范：优先通过 Maven/Gradle 管理依赖，拒绝手动放置 jar 包到资源目录，避免路径混乱和依赖缺失问题；

验证依赖完整性：引入juh依赖后，可通过「IDEA → Project Structure → Libraries」查看该依赖是否被正确识别，是否存在缺失；

避免路径过长：Windows 系统对文件路径长度有默认限制（传统路径最大 260 字符），避免创建过深的目录层级（如META-INF/resources/WEB-INF/lib/），可简化目录结构；

Jeecg 项目特殊说明：Jeecg 项目中使用juh组件时，通常已内置相关依赖配置，可检查项目的jeecg-boot-module-system模块的pom.xml，确认是否已引入juh相关依赖，避免重复配置或缺失；

打包验证：项目打包（jar/war）后，可解压打包文件，检查juh-3.2.1.jar是否被正确打包到对应目录（如 war 包的WEB-INF/lib/、jar 包的BOOT-INF/lib/）。

核心总结

该异常的核心是juh-3.2.1.jar文件缺失 + 路径配置错误（违背 Maven 项目规范）；

最优解决方案：通过 Maven 安装并引入依赖（公共仓库直接引入或本地安装），刷新依赖后清理错误目录；

关键原则：Java 项目的依赖 jar 包由构建工具（Maven/Gradle）统一管理，src/main/resources仅存放资源文件，不存放依赖 jar 包；

验证标准：IDEA 中外部库能看到juh-3.2.1，项目启动无FileNotFoundException，文档处理功能正常运行。