CXF未使用Spring配置的Bus：独立Java应用请求未走Bus

我之前在做CXF独立客户端的时候也碰到过一模一样的问题——容器里运行正常，独立环境下配置的出站头注入特性就是不生效，折腾了好一阵才找到根源。核心问题其实是独立应用中CXF不会自动帮你把Bus和客户端关联起来，容器环境下CXF的集成模块已经帮你做了这一步，但独立应用得手动处理。

下面是我总结的几个排查和解决方向：

1. 确保客户端使用的是你配置好特性的Bus #

默认情况下，CXF会创建一个默认的Bus实例，但如果你手动创建了带特性的Bus，客户端可能还是在使用默认Bus，导致特性没生效。解决办法是显式把自定义Bus绑定到客户端：

// 先创建并配置你的自定义Bus
Bus customBus = BusFactory.newInstance().createBus();
// 添加你的出站头注入特性
customBus.getFeatures().add(new YourHeaderInjectFeature());

// 创建客户端端口
YourServicePort port = Service.create(wsdlUrl, serviceQName).getPort(YourServicePort.class);

// 关键一步：把自定义Bus绑定到客户端实例
Client clientProxy = ClientProxy.getClient(port);
clientProxy.setBus(customBus);

2. 提前注册特性，不要在Bus启动后添加 #

如果你的特性是在Bus已经初始化完成后才添加的，那也不会生效。要确保在Bus启动前就把特性加进去，比如用BusBuilder来创建Bus并直接添加特性：

// 用BusBuilder更直观地创建带特性的Bus
Bus customBus = BusBuilder.newInstance().feature(new YourHeaderInjectFeature()).build();

3. 检查是否不小心创建了多个Bus实例 #

有时候在独立应用中，代码的不同部分可能会创建多个Bus实例，你配置特性的那个Bus和客户端实际使用的不是同一个。可以在特性的initialize方法里加日志，或者打印Bus的hashCode，确认客户端使用的Bus和你配置的是同一个：

@Override
public void initialize(InterceptorProvider provider, Bus bus) {
    super.initialize(provider, bus);
    System.out.println("特性已绑定到Bus: " + bus.hashCode());
    // 这里添加你的出站拦截器逻辑
}

然后在客户端代码里打印Bus的hashCode对比：

Client clientProxy = ClientProxy.getClient(port);
System.out.println("客户端使用的Bus: " + clientProxy.getBus().hashCode());

如果两个hashCode不一样，说明用的不是同一个Bus，就得调整代码确保客户端绑定到正确的Bus上。

4. 用系统属性指定默认Bus（可选） #

如果你不想手动绑定每个客户端，可以设置系统属性让CXF默认使用你配置的Bus：

// 在应用启动时设置
System.setProperty(BusFactory.BUS_FACTORY_PROPERTY, "org.apache.cxf.bus.CXFBusFactory");
// 然后初始化你的Bus并设置为默认
Bus customBus = BusBuilder.newInstance().feature(new YourHeaderInjectFeature()).build();
BusFactory.setDefaultBus(customBus);

这样后续创建的客户端都会自动使用这个默认Bus，不用再手动绑定了。

按上面的方法调整后，你的出站头注入特性应该就能在独立应用中正常触发了。

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