Weblogic 11g迁移至12c：SOAP服务遇SOAPException及LinkageError求助

我之前做Weblogic版本迁移时也碰到过一模一样的坑——12c对SOAP标准的执行严格度比11g高了不少，再加上类加载的兼容性问题，确实折腾人。给你几个实用的解决思路：

方案一：开启SAAJ宽松模式（最快捷，无需改代码/依赖） #

Weblogic自带的SAAJ实现其实有个隐藏参数可以绕过非命名空间头元素的校验，直接和11g的行为对齐。你只需要给Weblogic的JVM启动参数加上：

-Dcom.sun.xml.messaging.saaj.soap.impl.HeaderImpl.ALLOW_NON_NAMESPACE_QUALIFIED_HEADER_ELEMENT=true

这个参数会让HeaderImpl忽略对命名空间的强制检查，完全兼容客户端发送的无命名空间SOAP头，还能避免引入外部JAR包带来的类加载冲突，是最省心的方案。

方案二：正确配置类加载优先级（如果必须用外部SAAJ包） #

你之前的配置只指定了javax.xml.soap.*优先用应用包，但LinkageError的根源是：Weblogic自带的javax.xml.ws.handler.soap.SOAPMessageContext和应用里的SOAPMessage类来自不同类加载器，导致方法签名不匹配。需要把更多相关包加入优先加载列表：

修改weblogic.xml的prefer-application-packages配置：

<wls:prefer-application-packages>
    <wls:package-name>javax.xml.soap.*</wls:package-name>
    <wls:package-name>com.sun.xml.messaging.saaj.*</wls:package-name>
    <wls:package-name>javax.xml.ws.*</wls:package-name>
    <wls:package-name>com.sun.xml.ws.*</wls:package-name>
</wls:prefer-application-packages>

同时要保证WEB-INF/lib里的所有相关JAR版本兼容：saaj-impl 1.4.0需要搭配对应的jaxws-api（比如2.3.1版本），避免版本不匹配导致的隐性冲突。

方案三：代码层面手动修复SOAP头（无服务器配置依赖） #

如果以上两种方案都无法实施，可以在你的FlowValidationHandler里，解析SOAP头之前手动给无命名空间的元素补全命名空间：

public boolean handleMessage(SOAPMessageContext context) {
    try {
        SOAPMessage soapMessage = context.getMessage();
        SOAPHeader header = soapMessage.getSOAPHeader();
        if (header != null) {
            Iterator<?> headerElements = header.examineAllHeaderElements();
            while (headerElements.hasNext()) {
                SOAPHeaderElement headerElement = (SOAPHeaderElement) headerElements.next();
                // 检查是否缺少命名空间
                if (headerElement.getNamespaceURI() == null || headerElement.getNamespaceURI().trim().isEmpty()) {
                    // 可以设置为与SOAP Body相同的命名空间，或者自定义一个
                    SOAPBody body = soapMessage.getSOAPBody();
                    String bodyNamespace = body.getNamespaceURI();
                    headerElement.setNamespaceURI(bodyNamespace);
                    headerElement.setPrefix(body.getPrefix());
                }
            }
        }
        // 后续的业务逻辑处理
        return true;
    } catch (SOAPException e) {
        // 异常处理逻辑
        return false;
    }
}

这样处理后，Weblogic的SAAJ就会认为头元素符合标准，不会再抛出命名空间相关的异常。

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