使用Axis2创建Java SOAP Web Service遇Tomcat 500错误求助

核心问题1：Axis2版本与Tomcat10.1的规范不兼容 #

Tomcat10.1基于Jakarta EE 10（API包前缀为jakarta.*），而Axis2 1.8.2仅支持传统Java EE（API包前缀为javax.*），两者Servlet API不兼容，直接部署会触发类加载失败，伴随ClassNotFoundException。

解决方式二选一：

• 降级Tomcat到9.x版本（Java EE兼容版），适配Axis2 1.8.2
• 升级Axis2到1.9.0及以上版本（该版本开始支持Jakarta EE规范）

核心问题2：Axis2依赖包未正确部署 #

即使规范兼容，若Axis2核心jar包未被Tomcat加载，也会触发目标报错，解决步骤：

1. 收集必要依赖：确保包含axis2-core-1.8.2.jar、axis2-transport-http-1.8.2.jar、axis2-kernel-1.8.2.jar、commons-logging-1.2.jar、wsdl4j-1.6.3.jar等核心jar包
2. 正确放置依赖：将所有依赖jar放到项目的WEB-INF/lib目录下（Eclipse中需通过Deployment Assembly确认这些jar会被部署到Tomcat），或全局放到Tomcat的lib目录（不推荐）
3. 验证部署结果：启动Tomcat后，检查webapps/你的项目名/WEB-INF/lib下是否存在上述Axis2的jar包

验证web.xml配置正确性 #

确保web.xml中的AxisServlet配置无拼写错误，示例配置：

<servlet>
    <servlet-name>AxisServlet</servlet-name>
    <servlet-class>org.apache.axis2.transport.http.AxisServlet</servlet-class>
    <load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
    <servlet-name>AxisServlet</servlet-name>
    <url-pattern>/services/*</url-pattern>
</servlet-mapping>

后续测试 #

部署完成后，访问http://localhost:8080/你的项目名/services，若能看到Axis2的服务列表页面，说明部署成功。此时可通过SOAP UI导入http://localhost:8080/你的项目名/services/你的服务名?wsdl，或用Postman发送SOAP请求调用端点。

额外适配JDK17 #

Axis2 1.8.2在JDK17下运行需添加JVM启动参数，避免模块访问限制：

--add-opens java.base/java.lang=ALL-UNNAMED
--add-opens java.base/java.io=ALL-UNNAMED

可在Tomcat的catalina.bat（Windows）或catalina.sh（Linux）中添加该参数。

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