Apache Camel CXF @Oneway方法无法捕获SoapFault异常如何解决

你捕获不到Oneway方法抛出的SoapFault有两个核心原因：

1. CXF对@Oneway方法默认走异步调用逻辑：按SOAP规范，Oneway操作是单向的，客户端发送请求后不需要等待服务端响应就会继续执行后续逻辑。默认配置下CXF发送完Oneway请求就会把控制权交回Camel路由，服务端返回的SoapFault会在异步回调线程中抛出，完全不在当前路由的执行链路里，onException自然无法捕获。
2. onException定义位置错误：Camel的onException需要定义在路由最开头（from语句之后、业务逻辑之前）才能作用于整个路由流程，你现在把onException写在.to("cxf:bean:targetBean")之后，本身写法就不符合Camel的路由加载规则，普通方法能捕获属于偶发现象。

1. 强制CXF端点对Oneway方法走同步调用 #

要捕获Oneway方法的SoapFault，首先要打破默认的异步发送逻辑，让调用线程等待HTTP响应返回，只需要在target端的CxfEndpoint配置中开启同步模式即可：

@Bean(name = "targetBean")
public CxfEndpoint buildCxfSoapEndpoint() {
    CxfEndpoint cxf = new CxfEndpoint();
    cxf.setAddress("https://xxxx.com:443/api");
    cxf.setServiceClass(com.xxx.Service.class);
    cxf.setWsdlURL("wsdl/xxx.wsdl");
    // 新增：强制同步调用，Oneway方法也会等待HTTP响应
    cxf.setSynchronous(true);
    return cxf;
}

2. 修正onException的定义位置 #

把onException块挪到路由定义的最前端，确保异常处理逻辑作用于整个路由流程，修正后的路由代码如下：

// 异常处理必须定义在业务路由之前
onException(SoapFault.class)
    .handled(true) // 标记异常已处理，不会继续向上抛出
    .process(new Processor() {
        @Override
        public void process(Exchange exchange) throws Exception {
            SoapFault fault = exchange.getProperty(ExchangePropertyKey.EXCEPTION_CAUGHT, SoapFault.class);
            // 此处可正常获取Oneway方法抛出的SoapFault，按需设置消息体
            exchange.getIn().setBody(fault);
        }
    });

from("cxf:bean:sourceBean")
    .to("cxf:bean:targetBean");

按SOAP 1.1/1.2规范，@Oneway标注的单向操作服务端只需要返回202 Accepted状态码代表请求已接收，不应该返回任何业务层响应（包括SoapFault）。如果服务端是严格按规范实现，先返回202再异步处理业务逻辑抛出错误，客户端无论怎么配置都无法捕获到这类异常——这种情况需要先推动服务端修正接口实现，不要在Oneway方法中返回SoapFault。

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