能静态引用就别动态调用，除非需绕过代理生成、应对频繁WSDL变更或规避TLS/证书配置问题；Add Service Reference失败主因是WSDL不可达、地址为内网IP或.NET Framework版本低于4.6导致TLS 1.2未启用。
直接上结论：能静态引用就别动态调用，除非你明确需要绕过代理类生成、应对频繁变更的 WSDL 或规避 TLS/证书等配置陷阱。
为什么 Add Service Reference 会失败
不是代码问题，是前置条件没满足。最常见三个卡点：
- 浏览器打不开
http://xxx/Service.asmx?wsdl—— 返回 404、跳登录页、或 XML 被 HTML 包裹，Add Service Reference必定报错“无法下载元数据” - WSDL 中的
soap:address location是localhost或内网 IP —— 生成的代理类里new Uri("http://192.168.1.100/...")会连不通，得手动改Reference.cs - .NET Framework 版本低于 4.6 —— 服务只支持 TLS 1.2，但默认协议栈不启用，调用时抛
System.Net.WebException: 基础连接已经关闭；必须在Main()开头加ServicePointManager.SecurityProtocol = SecurityProtocolType.Tls12;
HttpClient 手写 SOAP 请求怎么写才不翻车
比代理类更可控，尤其适合只调一个方法、WSDL 不规范、或要精确控制 Header 的场景。关键不是拼 XML，而是对齐契约：
-
ContentType必须是text/xml; charset=utf-8（不是application/soap+xml），否则老 ASMX 服务直接 415 -
SOAPActionHeader 必须严格匹配 WSDL 里wsdl:operation的soapAction属性值，带英文引号，例如："http://tempuri.org/GetData" - XML 命名空间不能硬编码——从 WSDL 解析出
targetNamespace，再拼进请求体的根元素，比如<GetData xmlns="http://tempuri.org/"> - 参数是元素还是属性？看 WSDL 的
<xsd:element>和<xsd:attribute>定义，手写时错一个就收不到值
SoapHttpClientProtocol 动态调用的实际限制
它看起来“动态”，其实只是延迟绑定，底层仍依赖 WSDL 结构。真正问题出在运行时解析上：
- 构造实例后必须显式设
Url属性，否则走生成时硬编码的地址；client.Url = "https://prod.example.com/Service.asmx"; - 调用
Invoke("MethodName", new object[] { "a", 123 })时，参数顺序、类型、个数必须和 WSDL 完全一致，不支持命名参数或可选参数 - 返回值是
object，需手动转型；如果服务返回复杂嵌套对象，而本地没对应类型定义，反序列化会失败，抛InvalidOperationException - 它属于
System.Web.Services，.NET Core/.NET 5+ 默认不包含，得额外装System.Web.Services.Http包，且仅限 Windows 平台
dotnet-svcutil 生成客户端的避坑要点
这是 .NET Core / .NET 5+ 官方推荐方式，但容易忽略细节：
- 命令里必须带
?wsdl后缀，dotnet-svcutil https://api.example.com/Service.asmx会失败，得写成dotnet-svcutil https://api.example.com/Service.asmx?wsdl - 生成后只引用
System.ServiceModel.Http和System.ServiceModel.Primitives即可，别拉System.ServiceModel全家桶 - 如果服务用了
xs:choice或循环引用类型，生成类可能缺字段或编译报错；此时得加--serializer XmlSerializer参数强制用 XmlSerializer - Binding 配置别漏：
BasicHttpBinding默认最大消息尺寸是 64KB，传大文件或大数据集必炸，得在代码里设binding.MaxReceivedMessageSize = 20971520;（20MB）
动态调用真正的难点不在发请求，而在契约一致性——WSDL 变了，你手写的 XML、命名空间、Header、甚至参数顺序都得同步动。多数时候，花十分钟修好静态引用，比花两小时调试动态请求更省事。
