Gradle(WSDL2Java)生成CXF类时的基础类型端点适配异常

这个问题我之前也碰到过，核心原因是CXF无法直接将基本类型（比如boolean）映射到SOAP响应的结构中——SOAP要求响应必须是一个符合WSDL定义的结构化对象，而不是裸的基本类型。下面是具体的解决步骤：

1. 先确认你的WSDL定义是否正确 #

首先检查你的WSDL里是否为响应定义了对应的复杂类型。如果你的WSDL直接返回xs:boolean而没有包装成响应对象，那生成的Java代码必然会导致适配器错误。

正确的WSDL响应部分应该类似这样：

<!-- 定义响应消息 -->
<wsdl:message name="isActiveResponse">
  <wsdl:part name="parameters" element="tns:isActiveResponse"/>
</wsdl:message>

<!-- 定义响应元素的结构 -->
<xs:element name="isActiveResponse">
  <xs:complexType>
    <xs:sequence>
      <xs:element name="return" type="xs:boolean"/>
    </xs:sequence>
  </xs:complexType>
</xs:element>

<!-- 关联操作的输入输出 -->
<wsdl:operation name="isActive">
  <wsdl:input message="tns:isActiveRequest"/>
  <wsdl:output message="tns:isActiveResponse"/>
</wsdl:operation>

如果你的WSDL之前没有这样的结构，修改后重新用WSDL2Java生成代码，这是解决问题的根本。

2. 调整端点实现类，返回包装后的响应对象 #

用正确的WSDL生成代码后，你会得到IsActiveRequest和IsActiveResponse两个类（命名可能根据WSDL略有不同）。你的端点方法不能直接返回boolean，而是要返回生成的IsActiveResponse对象，把布尔值包装进去：

@Endpoint
public class IsActiveEndpoint {
    private static final String NAMESPACE_URI = "http://problem.com";

    @PayloadRoot(namespace = NAMESPACE_URI, localPart = "isActiveRequest")
    @ResponsePayload
    public IsActiveResponse handleIsActiveRequest(@RequestPayload IsActiveRequest request) {
        // 这里写你的业务逻辑，获取是否激活的结果
        boolean isActive = checkUserActive(request.getId());

        // 创建响应对象，把布尔值设置进去
        IsActiveResponse response = new IsActiveResponse();
        response.setReturn(isActive);
        return response;
    }

    private boolean checkUserActive(String id) {
        // 替换成你的实际业务判断
        return "1234".equals(id);
    }
}

3. 确保CXF依赖和Spring Boot配置正确 #

检查你的Gradle依赖是否包含了CXF的Spring Boot starter：

implementation 'org.apache.cxf:cxf-spring-boot-starter-jaxws:3.6.2'

（版本号可以根据你的Spring Boot版本调整，比如Spring Boot 3.x对应CXF 4.x）

另外，确保你的@Endpoint类能被Spring扫描到——要么把它放在启动类的同级或子包下，要么在启动类上用@ComponentScan指定扫描路径。

为什么会出现这个错误？ #

CXF的端点适配器需要处理符合SOAP规范的消息结构，而基本类型没有对应的SOAP元素结构，CXF找不到合适的适配器来将boolean转换成SOAP响应的XML结构。必须用WSDL定义的响应对象来包装这个值，才能让CXF正确序列化响应。

测试一下，现在发送你提供的请求，应该能得到类似这样的正确响应：

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
    <soap:Body>
        <ns:isActiveResponse xmlns:ns="http://problem.com">
            <return>true</return>
        </ns:isActiveResponse>
    </soap:Body>
</soap:Envelope>

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