如何获取Axis2调用触发AxisFault时的详细错误描述信息

直接从AxisFault对象提取内置属性 #

AxisFault本身已封装了完整的SOAP故障信息，可直接调用对应方法提取日志打印所需字段：

• getFaultReason()：返回服务端返回的具体故障描述，优先级高于通用的getMessage()方法
• getDetail()：返回服务端返回的自定义故障详情节点（OMElement类型），服务端抛出的异常栈、业务错误码、额外说明都会存储在该节点，可直接调用toString()打印完整XML内容
• getFaultCodeAsQName()：返回标准SOAP错误码，可快速区分是客户端参数错误、服务端内部错误、权限校验失败等分类问题

参考打印代码：

try {
    // 此处替换为你的Stub业务调用逻辑
    stub.sampleOperation(yourParams);
} catch (AxisFault e) {
    // 打印核心故障字段
    System.out.println("SOAP故障原因: " + e.getFaultReason());
    System.out.println("SOAP故障码: " + e.getFaultCodeAsQName());
    if (e.getDetail() != null) {
        System.out.println("SOAP故障详情: " + e.getDetail().toString());
    }
    // 保留原始栈信息用于排查
    e.printStackTrace();
}

开启Axis2客户端报文日志 #

如果AxisFault内置字段不足以定位问题，可开启报文打印直接查看完整的请求、响应原始SOAP内容：

代码方式开启 #

在Stub方法调用前添加如下配置：

// 适配服务端的SOAP版本，根据实际情况选择SOAP11/SOAP12
stub._getServiceClient().getOptions().setSoapVersion(org.apache.axis2.namespace.Constants.SOAP11_ENV);
// 开启报文追踪
stub._getServiceClient().getOptions().setProperty(org.apache.axis2.context.ConfigurationContextFactory.MESSAGE_TRACING, Boolean.TRUE);

日志框架配置 #

如果使用log4j/logback，调整对应包的日志级别即可自动输出完整HTTP报文、SOAP内容：

# log4j配置示例
log4j.logger.org.apache.axis2=DEBUG
log4j.logger.org.apache.axis2.transport.http=DEBUG
log4j.logger.httpclient.wire=DEBUG

辅助排查方式 #

• 拿客户端调用的参数直接用SoapUI工具模拟调用，对比返回结果，可快速区分是客户端Stub生成/参数封装错误，还是服务端本身的业务逻辑错误
• 部分服务端会将额外错误说明放在HTTP响应头中，开启HTTP调试日志后可同步查看响应头字段

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