Spring Boot 3中如何禁用SOAP响应中的错误详情？

针对Spring-WS中@PayloadRoot控制器方法在JAXB验证失败时返回带异常详情的SOAP错误问题，可通过以下几种方式解决：

方法一：自定义SOAP异常解析器 #

默认的SoapFaultMappingExceptionResolver会把异常详情暴露在SOAP错误中，你可以自定义这个解析器，对JAXB相关异常进行处理，隐藏敏感详情：

import org.springframework.ws.soap.server.endpoint.SoapFaultMappingExceptionResolver;
import org.springframework.ws.soap.server.endpoint.SoapFaultDefinition;
import org.springframework.ws.soap.SoapFault;
import javax.xml.bind.JAXBException;

public class CustomSoapFaultResolver extends SoapFaultMappingExceptionResolver {
    @Override
    protected SoapFault buildFault(Object endpoint, Exception ex, SoapFaultDefinition definition) {
        SoapFault fault = super.buildFault(endpoint, ex, definition);
        // 针对JAXB验证异常，清空详情并替换为通用提示
        if (ex instanceof JAXBException) {
            fault.getFaultDetail().getResult().clearContent();
            fault.getFaultDetail().addFaultDetailElement("error").setText("请求格式无效，请检查输入");
        }
        return fault;
    }
}

然后在配置类中注册这个自定义解析器：

@Bean
public SoapFaultMappingExceptionResolver customSoapFaultResolver() {
    CustomSoapFaultResolver resolver = new CustomSoapFaultResolver();
    SoapFaultDefinition defaultFault = new SoapFaultDefinition();
    defaultFault.setFaultCode(SoapFaultDefinition.SERVER);
    resolver.setDefaultFault(defaultFault);
    return resolver;
}

方法二：用@EndpointExceptionHandler处理特定异常 #

在你的Endpoint类中添加异常处理方法，直接捕获JAXB验证异常，返回自定义的简洁SOAP错误：

import org.springframework.ws.soap.server.endpoint.annotation.EndpointExceptionHandler;
import org.springframework.ws.soap.server.endpoint.annotation.FaultCode;
import org.springframework.ws.soap.server.endpoint.annotation.SoapFault;
import javax.xml.bind.JAXBException;

@Endpoint
public class YourXmlEndpoint {

    @PayloadRoot(namespace = "your-target-namespace", localPart = "YourRequestType")
    public YourResponseType handleRequest(@RequestPayload YourRequestType request) {
        // 业务逻辑处理
    }

    @EndpointExceptionHandler(JAXBException.class)
    @SoapFault(faultCode = FaultCode.CLIENT, faultStringOrReason = "请求格式不符合要求")
    public void handleJaxbValidationError(JAXBException ex) {
        // 无需返回内容，注解会生成不带详情的SOAP错误
    }
}

这种方式更精准，只针对JAXB相关异常生效，不会影响其他异常的处理逻辑。

方法三：关闭JAXB验证（可选） #

如果业务场景允许不需要XML格式验证，可以直接禁用JAXB的验证功能，从根源上避免验证异常：

@Bean
public Jaxb2Marshaller jaxb2Marshaller() {
    Jaxb2Marshaller marshaller = new Jaxb2Marshaller();
    marshaller.setContextPath("your.jaxb.model.package");
    // 禁用Schema验证
    marshaller.setSchema(null);
    // 或者设置忽略验证错误的处理器
    marshaller.setValidationEventHandler(event -> true);
    return marshaller;
}

注意：此方法会完全关闭XML结构验证，仅适用于不需要格式校验的场景。

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