Spring WebClient调用SOAP服务遇Encoder.encodeValue() UnsupportedOperationException

1. 确认自定义编码器未生效的核心原因 #

WebClient优先使用默认编解码器，若未正确替换或注册顺序错误，自定义实现会被忽略。检查配置代码，确保先移除默认JAXB编解码器，再注册自定义实现：

@Bean
public WebClient soapWebClient() {
    return WebClient.builder()
            .codecs(configurer -> {
                // 移除默认JAXB编解码器，避免优先级覆盖
                configurer.defaultCodecs().jaxb2Encoder(null);
                configurer.defaultCodecs().jaxb2Decoder(null);
                // 注册自定义SOAP编解码器
                configurer.customCodecs().register(new Jaxb2SoapEncoder());
                configurer.customCodecs().register(new Jaxb2SoapDecoder());
            })
            .build();
}

2. 定位UnsupportedOperationException: null的根源 #

异常来自spring-core-5.2.0.RELEASE的Encoder.encodeValue()，大概率是默认编码器（如Jaxb2XmlEncoder）不支持SOAP信封格式，或传入对象/类型不匹配。通过以下方式确认：

• 查看异常堆栈，确认执行的编码器是否为默认实现，以此验证自定义编码器是否未生效。
• 检查encodeValue方法参数：确认传入的value是否为null，请求的MimeType是否为SOAP标准的text/xml或application/soap+xml。

3. 自定义SOAP编解码器的关键实现要点 #

自定义编码器需正确处理SOAP信封封装，且canEncode方法要准确匹配请求场景：

public class Jaxb2SoapEncoder extends AbstractSingleValueEncoder<Object> {

    private final JaxbContext jaxbContext;

    public Jaxb2SoapEncoder() throws JAXBException {
        // 初始化JAXB上下文，传入你的SOAP请求实体类
        this.jaxbContext = JAXBContext.newInstance(YourSoapRequest.class);
    }

    @Override
    public boolean canEncode(ResolvableType elementType, MimeType mimeType) {
        // 匹配SOAP MIME类型与请求对象类型
        return (MimeTypeUtils.TEXT_XML.equals(mimeType) || MimeTypeUtils.APPLICATION_XML.equals(mimeType))
                && YourSoapRequest.class.isAssignableFrom(elementType.resolve());
    }

    @Override
    protected Flux<DataBuffer> encodeValue(Object value, DataBufferFactory bufferFactory, ResolvableType valueType, MimeType mimeType, Map<String, Object> hints) {
        try {
            // 封装SOAP信封
            String soapEnvelope = "<soapenv:Envelope xmlns:soapenv=\"http://schemas.xmlsoap.org/soap/envelope/\">"
                    + "<soapenv:Body>"
                    + marshalObjectToXml(value)
                    + "</soapenv:Body>"
                    + "</soapenv:Envelope>";
            DataBuffer buffer = bufferFactory.wrap(soapEnvelope.getBytes(StandardCharsets.UTF_8));
            return Flux.just(buffer);
        } catch (JAXBException e) {
            return Flux.error(new EncodingException("SOAP请求编码失败", e));
        }
    }

    private String marshalObjectToXml(Object value) throws JAXBException {
        StringWriter writer = new StringWriter();
        jaxbContext.createMarshaller().marshal(value, writer);
        return writer.toString();
    }
}

解码器需对应实现SOAP信封的解析逻辑，提取Body内的实际响应内容。

4. WebClient调用SOAP服务的正确姿势 #

调用时需指定正确的MIME类型，传入匹配的请求对象：

webClient.post()
        .uri("你的SOAP服务地址")
        .contentType(MimeTypeUtils.TEXT_XML)
        .bodyValue(yourSoapRequestInstance)
        .retrieve()
        .bodyToMono(YourSoapResponse.class)
        .block();

若服务要求application/soap+xml，替换对应contentType即可。

5. 额外兼容性排查点 #

• Spring Boot 2.2.0.RELEASE对SOAP原生支持有限，确保自定义编解码器继承自WebFlux的AbstractSingleValueEncoder基类。
• JDK 1.8.0_252需匹配兼容的JAXB依赖，避免版本冲突，可在pom.xml显式指定：

<dependency>
    <groupId>javax.xml.bind</groupId>
    <artifactId>jaxb-api</artifactId>
    <version>2.3.1</version>
</dependency>
<dependency>
    <groupId>com.sun.xml.bind</groupId>
    <artifactId>jaxb-impl</artifactId>
    <version>2.3.3</version>
    <scope>runtime</scope>
</dependency>

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