Spring Boot WebService部署失败:排查Jar包缺失问题
在Spring Boot中构建WebService服务时,部署和运行问题时有发生。本文分析一个常见的案例:“Spring Boot构建的WebService服务发布测试失败,提示找不到Jar包”。
问题描述:
运行程序时抛出java.lang.NoClassDefFoundError: org/eclipse/jetty/server/SessionManager
异常,表明找不到org.eclipse.jetty.server.SessionManager
类。该错误出现在使用CXF框架发布WebService服务时。错误信息片段如下:
20:45:16.837 [main] DEBUG org.apache.cxf.resource.DefaultResourceManager - resolving resource type
20:45:16.837 [main] DEBUG org.apache.cxf.resource.DefaultResourceManager - resolving resource type
20:45:16.932 [main] DEBUG org.apache.cxf.transport.http_jetty.JettyHttpServerEngineFactory - creating jetty http server engine for port 8000.
Exception in thread "main" java.lang.NoClassDefFoundError: org/eclipse/jetty/server/SessionManager
at org.apache.cxf.transport.http_jetty.JettyHttpServerEngineFactory.getOrCreate(JettyHttpServerEngineFactory.java:116)
...
Caused by: java.lang.ClassNotFoundException: org.eclipse.jetty.server.SessionManager
at java.net.URLClassLoader.findClass(URLClassLoader.java:382)
...
错误提示缺少Jetty相关的Jar包,而Jetty是CXF默认使用的HTTP服务器之一。代码使用了JaxWsServerFactoryBean
发布服务,说明这是一个基于CXF的WebService项目。
问题分析与解决:
根本原因是项目缺少必要的Jetty依赖。虽然可能已添加部分依赖,但这些依赖可能不适用于Spring Boot环境。 Spring Boot推荐使用cxf-spring-boot-starter-jaxws
简化CXF集成。此外,还需要添加cxf-rt-transports-http-jetty
和cxf-rt-transports-websocket
(如果需要Websocket支持)来支持Jetty HTTP传输和Websocket传输。
正确的依赖配置如下:
org.apache.cxf cxf-spring-boot-starter-jaxws 3.5.5 org.apache.cxf cxf-rt-transports-websocket 3.5.5 org.apache.cxf cxf-rt-transports-http-jetty 3.5.5
添加这些依赖后,项目将包含Jetty相关的类,解决java.lang.NoClassDefFoundError: org/eclipse/jetty/server/SessionManager
异常,成功发布WebService服务。 请根据实际情况选择合适的版本号,例如替换3.5.5
为最新稳定版本。