NetBeans使用免费Spire.Doc.jar处理docx：运行正常但构建报类缺失错误

• 业务场景：为处理.docx格式文件，安装了免费版Spire.Doc.jar
• 运行表现：NetBeans环境内直接运行程序时，Spire.Doc相关功能可正常调用
• 构建报错：执行项目构建操作时，编译器抛出如下错误：

warning: Supported source version 'RELEASE_6' from annotation processor 'org.eclipse.persistence.internal.jpa.modelgen.CanonicalModelProcessor' less than -source '1.8'
Note: Creating static metadata factory ...
error: com.sun.tools.javac.code.Symbol$CompletionFailure: class file for com.spire.doc.packages.spryOb$1 not found
An annotation processor threw an uncaught exception.
Consult the following stack trace for details.
java.lang.RuntimeException: com.sun.tools.javac.code.Symbol$CompletionFailure: class file for com.spire.doc.packages.spryOb$1 not found

• 已完成排查：已将Spire.Doc.jar添加至项目类路径，检测发现com.spire.doc.packages路径下确实缺失报错提及的对应类文件
• 核心疑问：报错属于NetBeans环境配置问题，还是Spire.Doc.jar本身存在异常；为何运行程序时功能完全正常，仅构建项目时触发报错

• 基础判断：该故障不属于NetBeans的基础环境配置问题
• 运行与构建的逻辑差异：NetBeans的「运行项目」动作默认跳过全量类路径引用校验，仅加载已编译生成的class文件、执行主程序入口方法，不会主动扫描第三方jar包内所有类的完整性，因此缺失的类不会被触发加载，功能可正常使用
• 构建报错的触发链路：项目构建阶段会执行javac全量编译，此时EclipseLink的JPA注解处理器CanonicalModelProcessor会遍历全类路径完成注解扫描、静态元数据生成；免费版Spire.Doc的jar包做了商业混淆加密，预埋了仅在付费版本中提供的内部混淆类引用，当编译器扫描到com.spire.doc.packages.spryOb$1的类引用时，因为对应class文件未随免费版发布，最终抛出CompletionFailure未捕获异常
• 附带警告说明：提示的EclipseLink注解处理器支持RELEASE_6源码版本、低于项目1.8源码要求的警告，属于独立的依赖版本兼容问题，和Spire.Doc的报错没有直接因果关系

• 替换为完整授权版本的Spire.Doc jar包，补全所有加密混淆的内部类引用，从根源上解决类缺失问题
• 若继续使用免费版，可调整NetBeans项目的编译参数：将Spire.Doc的jar包排除在注解处理器的扫描范围外，关闭构建阶段对第三方jar包的全量类引用完整性校验，避免javac遍历到未发布的内部类引用
• 针对EclipseLink的版本警告，可升级对应JPA注解处理器的依赖版本，匹配项目1.8的源码编译要求

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