基于含外部XSD的现有WSDL搭建Spring WebService失败求助

看来你在把Weblogic上的SOAP服务迁移到Spring环境时碰了壁，这种带外部XSD引用+共用Fault的场景确实容易踩坑，我来给你捋捋几个关键排查方向和解决办法：

1. 确认Spring WS对外部XSD的解析配置 #

Spring WS默认的Schema处理逻辑和Weblogic有差异，你得确保所有外部XSD都被正确加载：

• 检查你的WebServiceConfig类（或XML配置）里的DefaultWsdl11Definition，一定要把所有请求、响应和Fault的XSD都通过xsdSchemaCollection注册，不能只关联WSDL文件。示例代码如下：

  @Bean
  public DefaultWsdl11Definition transactionsWsdl(XsdSchemaCollection transactionSchemas) {
      DefaultWsdl11Definition wsdl11Definition = new DefaultWsdl11Definition();
      wsdl11Definition.setPortTypeName("TransactionsPort");
      wsdl11Definition.setLocationUri("/ws");
      wsdl11Definition.setTargetNamespace("你的服务目标命名空间");
      wsdl11Definition.setSchemaCollection(transactionSchemas);
      return wsdl11Definition;
  }
  
  @Bean
  public XsdSchemaCollection transactionSchemas() {
      return new CommonsXsdSchemaCollection(
          new ClassPathResource("wsdl/transactions/FindTransactionRequest.xsd"),
          new ClassPathResource("wsdl/transactions/FindTransactionResponse.xsd"),
          new ClassPathResource("wsdl/transactions/RemoveTransactionRequest.xsd"),
          // 把剩余的请求响应XSD和FaultMessage.xsd都添加进来
          new ClassPathResource("wsdl/transactions/FaultMessage.xsd")
      );
  }
  

• 重点核对XSD与WSDL中的命名空间是否完全一致，Spring WS对命名空间的匹配要求很严格，Weblogic可能有更宽松的兼容逻辑。

2. 验证共用Fault的处理逻辑 #

Weblogic对SOAP Fault的兼容度更高，Spring WS需要明确的配置才能正确识别共用Fault：

• 检查WSDL中对FaultMessage.xsd的引用是否正确，同时确保你的Endpoint类能正确抛出对应异常，并用@SoapFault注解标记：

  @SoapFault(faultCode = SoapFaultDefinition.SERVER, faultStringOrReason = "交易处理异常")
  public class TransactionFault extends RuntimeException {
      // 自定义构造方法
      public TransactionFault(String message) {
          super(message);
      }
  }
  

• 确认FaultMessage.xsd中的结构符合SOAP规范，比如faultcode、faultstring等核心元素的命名和类型不能出错。

3. 排查类路径与资源加载问题 #

Spring加载资源的方式和Weblogic不同，容易出现文件找不到的情况：

• 确认所有WSDL和XSD文件都在src/main/resources/wsdl/transactions目录下，打包后能在classpath中被找到。可以通过ClassPathResource的exists()方法验证资源是否可加载。
• 如果XSD之间存在互相引用（比如Fault被其他XSD引用），可以在CommonsXsdSchemaCollection中设置setInline(true)，让Spring自动合并Schema，避免相对路径引用的问题。

4. 借助日志定位具体错误 #

如果以上配置都没问题，一定要打开Spring WS的DEBUG日志，这是定位问题的关键：

• 在application.properties中添加日志配置：

  logging.level.org.springframework.ws=DEBUG
  logging.level.org.springframework.xml=DEBUG
  

• 日志会详细输出Schema解析失败原因、命名空间不匹配、Fault处理异常等细节，帮你快速锁定问题点。

5. 对比Weblogic与Spring生成的WSDL #

把Weblogic上发布的WSDL和Spring WS生成的WSDL做对比，重点检查：

• 命名空间是否一致
• Schema引用是否完整
• Fault定义部分是否对齐
  Spring WS可能会自动生成一些额外元素或遗漏某些引用，这时候需要调整配置来匹配Weblogic的输出格式。

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