Eclipse生成Java WebService客户端无法初始化Stub类报错咨询

根本原因 #

你遇到的java.lang.NoClassDefFoundError: Could not initialize class com.javapapers.jee.AnimalTypeServiceSoapBindingStub错误，核心原因不是Stub类本身不存在，而是Stub类的静态初始化过程执行失败，JVM会直接标记该类为不可初始化状态，后续所有加载该类的请求都会直接抛出该错误。
绝大多数此类场景是WebService客户端运行所需的依赖库没有随项目部署到Tomcat的运行时类路径下，Stub类静态初始化时依赖的SOAP序列化、网络通信相关类找不到，直接导致初始化失败。

问题归属 #

这不属于Eclipse本身的Bug，属于Java Web项目的类路径依赖缺失问题，是Eclipse生成WebService客户端时，默认没有将Web服务运行时依赖包自动加入项目的发布装配清单导致的。

• 先检查客户端项目的WEB-INF/lib目录，确认是否包含Axis/Axis2、jaxrpc、saaj、commons-logging、commons-discovery这类WebService客户端运行必需的Jar包。如果缺失可以在Eclipse的项目属性-部署装配（Deployment Assembly）配置页，将Web Service Runtime库添加到发布清单中，重新部署即可。
• 重启Tomcat后首次触发客户端调用，查看控制台输出的首个异常栈：你当前贴出的栈是类初始化失败后的后续调用报错，没有包含静态初始化失败的原始原因，首次调用的报错会明确给出具体是缺失哪个依赖类，或是静态初始化过程中的其他错误（比如WSDL地址不可访问）。
• 确认Tomcat运行使用的JDK版本和项目编译版本一致：你设置的编译版本是Java 8，要检查Tomcat启动时使用的JDK也是Java 8，避免版本不兼容导致的类初始化失败。
• 检查生成的Stub类中硬编码的WSDL地址：部分版本的Eclipse生成Stub时会将WSDL路径写成本地开发环境的绝对路径，部署后无法访问也会导致静态初始化失败，可以将WSDL地址修改为服务端的可访问HTTP地址，或是将WSDL文件放到项目类路径下用相对路径加载。

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