Apache CXF 3.2.2客户端单向操作SOAP错误信息获取问题

我之前也碰到过类似的问题，单向操作下CXF的故障拦截器确实有不少容易踩的坑，咱们一步步来排查和解决：

单向操作（one-way）默认设计是不期望服务端返回响应的，CXF客户端发送请求后会立刻释放连接，不会等待服务端的反馈——哪怕服务端返回了SOAP Fault。这是你拦截器没触发的核心原因之一。

你需要强制客户端等待可能的Fault响应，在获取Client实例后添加这两个配置：

Client client = ClientProxy.getClient(yourServicePort);
// 设置超时时间，确保客户端有足够时间等待Fault响应
client.getRequestContext().put("javax.xml.ws.receiveTimeout", 30000);
// 开启单向操作的响应接收开关
client.getRequestContext().put("org.apache.cxf.oneway.receive.response", Boolean.TRUE);

你提到把IncomingFaultInterceptor加到了cxfEndpoint的inFaultInterceptors，但注意：客户端的拦截器要加到Client实例的inFault链，不是服务端Endpoint。

正确的代码添加方式： #

Client client = ClientProxy.getClient(yourServicePort);
client.getInFaultInterceptors().add(new IncomingFaultInterceptor());

拦截器的实现要注意Phase选择 #

确保你的拦截器继承AbstractPhaseInterceptor<Message>，并指定合适的阶段（比如Phase.RECEIVE，这是客户端刚收到响应的阶段，能第一时间捕获Fault）：

public class IncomingFaultInterceptor extends AbstractPhaseInterceptor<Message> {
    public IncomingFaultInterceptor() {
        super(Phase.RECEIVE); // 选对阶段很关键
    }

    @Override
    public void handleMessage(Message message) throws Fault {
        // 提取Fault信息
        Fault fault = (Fault) message.getContent(Exception.class);
        System.out.println("SOAP错误码：" + fault.getFaultCode());
        System.out.println("错误信息：" + fault.getMessage());
        // 可以在这里做自定义处理，比如把Fault转为业务异常抛出
    }
}

有时候服务端返回的Fault格式不规范（比如缺少<faultcode>、<faultstring>等必填元素），CXF无法识别为标准Fault，自然不会触发inFault拦截器。

你可以开启CXF的日志拦截器，打印实际的SOAP报文，确认服务端的响应：

client.getInInterceptors().add(new LoggingInInterceptor());
client.getOutInterceptors().add(new LoggingOutInterceptor());

这样就能在控制台看到完整的请求和响应内容，判断服务端是否真的返回了符合规范的SOAP Fault。

如果有其他拦截器在你的IncomingFaultInterceptor之前的阶段捕获了Fault，并且没有把异常传递下去，你的拦截器就不会被触发。可以打印拦截器链的顺序来确认：

List<Interceptor<? extends Message>> interceptors = client.getInFaultInterceptors();
for (Interceptor<?> interceptor : interceptors) {
    System.out.println("InFault拦截器：" + interceptor.getClass().getName() + "，阶段：" + interceptor.getPhase());
}

确保你的拦截器在正确的位置，且前面的拦截器没有消费掉Fault。

如果拦截器还是没触发，可以尝试给客户端设置ExceptionHandler，直接捕获调用时的异常：

client.getRequestContext().put("javax.xml.ws.exception.handler", new ExceptionHandler() {
    @Override
    public boolean handleException(Throwable throwable) {
        if (throwable instanceof Fault) {
            Fault fault = (Fault) throwable;
            System.out.println("捕获到SOAP Fault：" + fault.getFaultCode() + " - " + fault.getMessage());
            return true; // 返回true表示已处理，不再向上抛出
        }
        return false;
    }
});

这种方式在开启了单向响应接收后，也能有效捕获服务端返回的Fault。

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