Tomcat 9.0.52+Axis2 1.8.0服务报processAxisFault空HTTP状态错误后终止如何排查修复

报错描述 #

Apache Tomcat 9.0.52 与 Axis2 1.8.0 环境下部署服务启动后抛出如下错误，报错后程序直接停止运行无后续响应：

ERROR org.apache.axis2.transport.http.AxisServlet - processAxisFault() found a null HTTP status from the MessageContext instance, setting HttpServletResponse status to: axis2.http.response.state

排查方向 #

• 检查axis2.xml核心配置：确认是否缺失axis2.http.response.state参数配置，或参数值为非合法HTTP状态码
• 排查自定义业务逻辑：检查自研的Axis2服务实现、消息拦截器代码，是否存在异常分支下未给MessageContext设置HTTP状态码、甚至主动清空该属性的逻辑
• 核对依赖兼容性：确认项目引入的servlet-api包是否与Tomcat 9自带的servlet-api版本冲突，是否存在多版本Axis2依赖共存的问题
• 验证请求报文合法性：抓包确认触发报错的请求报文是否符合服务WSDL定义的格式规范，非法报文可能导致Axis2解析异常无法生成状态码

修复方案 #

• 补全Axis2默认配置：在axis2.xml配置文件中添加如下参数，设置异常场景下默认的HTTP响应状态码：

  <parameter name="axis2.http.response.state">500</parameter>
  

• 完善自定义异常逻辑：在自研服务、拦截器的异常捕获分支中，显式为MessageContext设置HTTP状态码，参考代码：
  messageContext.setProperty(org.apache.axis2.Constants.HTTP_RESPONSE_CODE, 500);
• 统一依赖版本：排除项目中自行引入的servlet-api依赖，直接使用Tomcat 9提供的servlet-api实现，同时确保所有Axis2相关依赖版本统一为1.8.0，无多版本冲突
• 前置报文校验：在请求进入Axis2核心处理流程前新增报文合法性校验逻辑，提前拦截非法请求并返回明确响应，避免触发Axis2底层空状态码异常

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