Apache CXF：通过代码修改SOAP Header的To元素值？首请求异常排查

问题现象 #

自定义CXF拦截器修改SOAP Header的To元素，日志显示值已成功修改，但首次WebService调用仍发送旧值，第二次及之后调用正常。

核心原因 #

你选择的拦截器阶段Phase.PREPARE_SEND_ENDING时机太晚：

• CXF处理请求时，SOAP消息序列化、请求目标URL确定等关键操作，会在PREPARE_SEND_ENDING之前的阶段完成。首次调用时，即便修改了To头的对象值，此时SOAP消息内容已生成完毕，修改无法同步到实际发送的请求里；第二次调用时，客户端缓存的元数据已更新，修改的To值才会生效。
• 另外，CXF的Addressing模块会将To头与实际请求URL绑定，仅修改To头对象值、未同步更新请求URL，也会导致首次调用时实际发送地址不匹配。

解决方案 #

1. 调整拦截器到更早的阶段 #

选择在SOAP消息序列化之前的阶段执行修改，比如Phase.WRITE或Phase.PRE_PROTOCOL，确保修改能被写入最终发送的SOAP消息。

2. 同步更新请求URL #

在修改To头的同时，设置Message中的实际请求地址，保证To头与实际发送URL一致。

修改后的拦截器代码 #

public class SoapHeaderChangerInterceptor extends AbstractPhaseInterceptor<Message> {

    private static final Logger logger = LoggerFactory.getLogger(SoapHeaderChangerInterceptor.class);
    private static final String NEW_SERVER_URL = "https://MY_NEW_SERVER_URL";

    public SoapHeaderChangerInterceptor() {
        // 调整到更早的阶段，确保在消息序列化前完成修改
        super(Phase.WRITE);
    }

    @Override
    public void handleMessage(Message m) throws Fault {
        // 同步更新实际请求URL
        m.put(Message.ENDPOINT_ADDRESS, NEW_SERVER_URL);

        List<SoapHeader> headers = (List<SoapHeader>) m.get("org.apache.cxf.headers.Header.list");
        for(SoapHeader h : headers) {
            if ("To".equalsIgnoreCase(h.getName().getLocalPart())) {
                JAXBElement<?> object = (JAXBElement<?>) h.getObject();
                if (object.getValue() instanceof AttributedURIType) {
                    AttributedURIType t = (AttributedURIType) object.getValue();
                    logger.info("Addressing header found: '" + t.getValue() + "'");
                    t.setValue(NEW_SERVER_URL);
                    logger.info("Addressing header replaced to: '" + t.getValue() + "'");
                    break;
                }
            }
        }
    }
}

额外验证点 #

• 确保拦截器被正确注册到客户端的Interceptor链中，而非仅服务端。
• 若使用CXF的AddressingFeature，可检查是否开启了缓存，必要时禁用或手动刷新元数据。

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