Spring Boot SOAP服务WSDL地址替换为API管理层URL的问题

我之前部署云端SOAP服务时也碰到过一模一样的问题，折腾了好一阵才搞定，给你分享两个经过验证的解决方案：

方法一：正确配置DefaultWsdl11Definition的locationUri #

你之前用setLocationUri()没生效，大概率是配置细节没处理对。要确保直接把API管理层的完整URL硬编码进去，而不是相对路径。比如：

@Configuration
@EnableWs
public class WebServiceConfig extends WsConfigurerAdapter {

    @Bean
    public XsdSchema countriesSchema() {
        return new SimpleXsdSchema(new ClassPathResource("countries.xsd"));
    }

    @Bean(name = "countries")
    public DefaultWsdl11Definition defaultWsdl11Definition(XsdSchema countriesSchema) {
        DefaultWsdl11Definition wsdlDefinition = new DefaultWsdl11Definition();
        wsdlDefinition.setPortTypeName("CountriesPort");
        // 这里直接写API管理层的完整URL
        wsdlDefinition.setLocationUri("https://your-api-management-domain.com/soap-endpoint");
        wsdlDefinition.setTargetNamespace("http://your-domain.com/countries");
        wsdlDefinition.setSchema(countriesSchema);
        return wsdlDefinition;
    }
}

注意：这个配置会直接把WSDL里的soap:address的location属性设置成你指定的API层URL，不管后端服务的实际部署地址。如果部署后还是没生效，检查一下是不是Spring Boot的MessageDispatcherServlet映射路径和这个配置冲突——确保Servlet的映射（默认是/ws/*）不影响这个硬编码地址的输出。

方法二：使用自定义WSDL文件（避免Maven构建覆盖） #

如果你想用手动编辑的WSDL，核心是要防止Maven构建过程中自动生成的WSDL覆盖你修改的版本。步骤如下：

1. 把手动修改好的WSDL文件（已经把soap:address的location改成API层URL）放到src/main/resources目录下，比如命名为countries-custom.wsdl。
2. 在配置类中直接加载这个自定义WSDL：

@Bean(name = "countries")
public SimpleWsdl11Definition countriesWsdl() {
    // 加载自定义的WSDL文件
    return new SimpleWsdl11Definition(new ClassPathResource("countries-custom.wsdl"));
}

3. 调整Maven插件配置（如果用了jaxb2-maven-plugin），让它只生成Java实体类，不自动生成WSDL文件。比如在插件配置里去掉wsdlGenerator相关的配置，或者指定生成的WSDL路径不覆盖你的自定义文件。

额外排查点 #

如果还是没生效，建议：

• 部署到云端后，直接访问WSDL地址（比如https://your-cloud-domain/ws/countries.wsdl），查看soap:address的location值是不是你要的API层URL。
• 检查API管理层的路由规则，确保它能正确转发请求到你的后端SOAP服务。

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