如何自定义JAX-WS中WebMethod执行前RuntimeException的响应？

你遇到的问题核心在于：XML解析、参数绑定、方法匹配这类异常发生在JAX-WS的消息预处理阶段，早于@HandlerChain注解的处理器执行时机，因此Handler无法拦截这些异常并修改响应。以下是针对Metro（JAX-WS RI，你示例中使用EclipseLink OXM，大概率基于此实现）的可行解决方案：

1. 自定义异常处理器 #

实现JAX-WS的ExceptionHandler接口，捕获并转换早期异常为自定义SOAP Fault：

import com.sun.xml.ws.api.server.ExceptionHandler;
import com.sun.xml.ws.api.server.WSWebServiceContext;
import com.sun.xml.ws.fault.SOAPFaultBuilder;
import jakarta.xml.soap.SOAPFault;
import jakarta.xml.ws.WebServiceException;
import jakarta.xml.ws.soap.SOAPFaultException;
import org.eclipse.persistence.exceptions.XMLMarshalException;
import java.lang.reflect.InvocationTargetException;

public class CustomSOAPExceptionHandler implements ExceptionHandler {

    @Override
    public Throwable handleException(Throwable throwable, WSWebServiceContext context) {
        // 获取根异常，剥离包装层
        Throwable rootCause = getRootCause(throwable);

        // 处理参数类型转换异常（如String转Integer失败）
        if (rootCause instanceof XMLMarshalException || rootCause instanceof NumberFormatException) {
            SOAPFault fault = buildCustomFault("Client.InvalidArgument", "参数格式错误：toolNumber必须为整数类型");
            return new SOAPFaultException(fault);
        }

        // 处理请求方法不存在的异常
        if (rootCause instanceof NoSuchMethodException || throwable instanceof InvocationTargetException) {
            SOAPFault fault = buildCustomFault("Client.InvalidMethod", "请求的方法不存在或参数不匹配");
            return new SOAPFaultException(fault);
        }

        // 其他异常沿用默认处理逻辑
        return SOAPFaultBuilder.createSOAPFault(throwable, context.getBinding());
    }

    private Throwable getRootCause(Throwable throwable) {
        while (throwable.getCause() != null) {
            throwable = throwable.getCause();
        }
        return throwable;
    }

    private SOAPFault buildCustomFault(String faultCode, String faultString) {
        try {
            SOAPFault fault = SOAPFaultBuilder.createSOAPFault();
            fault.setFaultCode(faultCode);
            fault.setFaultString(faultString);
            return fault;
        } catch (Exception e) {
            throw new WebServiceException("创建自定义SOAP Fault失败", e);
        }
    }
}

2. 注册异常处理器 #

根据服务发布方式选择对应的注册方式：

代码发布Endpoint #

如果通过Java代码直接发布服务，在创建Endpoint后绑定自定义处理器：

import jakarta.xml.ws.Endpoint;

public class CopyToolServicePublisher {
    public static void main(String[] args) {
        String serviceUrl = "http://localhost:8080/CopyToolService";
        CopyToolServiceImpl serviceImpl = new CopyToolServiceImpl();
        Endpoint endpoint = Endpoint.publish(serviceUrl, serviceImpl);
        
        // 绑定自定义异常处理器
        endpoint.setProperty(
            com.sun.xml.ws.api.server.ExceptionHandler.class.getName(),
            new CustomSOAPExceptionHandler()
        );
    }
}

Web容器发布（如Tomcat） #

在web.xml中添加上下文参数，指定处理器类全路径：

<web-app>
    <!-- 其他服务配置 -->
    <context-param>
        <param-name>com.sun.xml.ws.server.exceptionHandler</param-name>
        <param-value>com.acme.CustomSOAPExceptionHandler</param-value>
    </context-param>
</web-app>

3. 预期效果 #

针对你提供的测试请求，自定义后的响应会变为：

<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
   <S:Body>
      <ns0:Fault xmlns:ns0="http://schemas.xmlsoap.org/soap/envelope/">
         <faultcode>Client.InvalidArgument</faultcode>
         <faultstring>参数格式错误：toolNumber必须为整数类型</faultstring>
      </ns0:Fault>
   </S:Body>
</S:Envelope>

关键说明 #

• @HandlerChain的处理器仅在消息绑定完成后、WebMethod调用前后执行，无法捕获JAX-WS框架在预处理阶段抛出的异常（如XML解组、方法匹配失败）。
• 上述方案基于Metro实现，若使用Apache CXF等其他JAX-WS实现，需改用对应框架的异常拦截器（如CXF的FaultListener）。

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