IDEA构建支持Word编辑的独立jar 引入POI5.0报HWPF类找不到错误

• 检查IDEA Artifact打包规则

你当前的可执行Jar打包配置没有将POI相关依赖纳入最终产物，可按以下步骤修正：进入IDEA的File > Project Structure > Artifacts设置页，选中你配置的可执行Jar构建项，在右侧「Available Elements」列表中找到poi、poi-scratchpad及相关依赖库，右键选择「Extract Into Output Root」，将依赖类直接合并到最终生成的Jar中，也可以选择「Put into Output Root」将第三方Jar单独放置在输出目录，同步在MANIFEST.MF的Class-Path字段中配置依赖Jar的相对路径。

• 补充缺失的POI传递依赖

Apache POI 5.0的运行除了poi、poi-scratchpad主包外，还需要commons-codec、commons-io、commons-collections4等公共依赖，你当前仅引入了两个主包，缺少传递依赖也会触发类找不到错误。如果是Maven/Gradle项目建议直接通过包管理工具引入POI依赖，会自动下载所有传递依赖；如果是手动导包，需要去Apache POI官网下载完整的发行包，将lib目录下的所有相关Jar都导入项目。

• 检查依赖的Scope配置

进入Project Structure > Libraries页，确认poi、poi-scratchpad两个依赖的Scope没有被设置为Provided，Scope为Provided的依赖仅会参与编译，不会被打包到最终的可执行Jar中，改为Compile即可解决。

• 本地运行验证

先直接在IDEA中启动项目（不打包为Jar运行），如果本地运行也抛出相同错误，优先排查依赖缺失问题；如果本地运行正常，仅打包后运行报错，优先排查Artifact打包配置问题。

内容的提问来源于stack exchange，提问作者Alexander Verzakov