WSDL 端口

WSDL 中的「端口」（port）到底是什么？一文彻底说清楚

在 WSDL 里，port（有的工具显示成 endpoint）是整个文档里最接近“真实调用地址”的概念，它把抽象接口和具体网络地址绑在一起。

官方定义（简单翻译）

<service>
    <port name="xxxPort" binding="tns:某个Binding">
        <soap:address location="https://真的能访问的URL"/>
    </port>
</service>

port = 一个具体的部署实例 = “抽象接口 + 协议细节 + 真实 URL”

真实例子对比（一看就懂）

场景	WSDL 里对应的 port 写法	实际你要调的地址
生产环境	<soap:address location="https://api.example.com/prod/soap"/>	https://api.example.com/prod/soap
测试环境	<soap:address location="https://test.example.com/soap"/>	https://test.example.com/soap
同一个接口，HTTP 和 HTTPS 都支持	写两个 port	分别给两个地址
同一个接口，既支持 SOAP1.1 又支持 SOAP1.2	写两个 port（binding 不同）	地址可以一样，但 Content-Type 不同

经典的多个 port 真实写法（生产项目常见）

<service name="OrderService">
    <!-- 生产环境 SOAP 1.1 -->
    <port name="OrderSoap11Prod" binding="tns:OrderSoap11Binding">
        <soap:address location="https://api.company.com/soap/order/v1"/>
    </port>

    <!-- 测试环境 SOAP 1.1 -->
    <port name="OrderSoap11Test" binding="tns:OrderSoap11Binding">
        <soap:address location="https://test-api.company.com/soap/order/v1"/>
    </port>

    <!-- 生产环境 SOAP 1.2（可选） -->
    <port name="OrderSoap12Prod" binding="tns:OrderSoap12Binding">
        <soap12:address location="https://api.company.com/soap/order/v1"/>
    </port>
</service>

各种工具里怎么显示 port

工具	显示名称	你应该点哪个
SoapUI	自动列出所有 port 下拉框	选“OrderSoap11Prod” → 自动填对 URL
Postman	导入 WSDL 后出现多个 Endpoint	直接切换就行
Java (CXF/JAX-WS)	自动读取第一个 port，或用 -p 参数指定	不指定默认第一个
.NET svcutil	自动读取第一个，或加 /serviceName 参数
Python Zeep	client = Client(wsdl, port=”OrderSoap11Prod”)	必须显式指定

99% 的人踩过的坑

1. 只看 WSDL 里第一个 port，结果调的是测试地址，生产数据乱了
2. 没注意到有 SOAP1.1 和 SOAP1.2 两个 port，Content-Type 写错了，一直 500
3. 改了服务器 IP，但没改 WSDL 里的 <soap:address>，所有客户端全挂

一句话总结

WSDL 中的 port 就是“调用入口”，一个服务可以有多个 port（生产/测试、内网/外网、SOAP1.1/1.2），你真正要 POST 数据的 URL 就写在 <soap:address location="..."/> 里面。

需要我给你：

• 一个包含 4 个 port（生产/测试 + SOAP1.1/1.2）的完整 WSDL 示例
• 或者教你怎么用 SoapUI/Postman 一键切换不同 port
  直接说！