应使用Visual Studio“添加服务引用”生成强类型客户端而非手写HttpWebRequest。因ASMX是带WSDL的SOAP服务，手动拼XML易错：Content-Type缺charset致500、SOAPAction大小写敏感、命名空间或Envelope结构偏差致400或空响应、无类型映射需手动序列化。
直接用 Visual Studio 自带的“添加服务引用”就能生成强类型客户端，别手写 HttpWebRequest 调用 SOAP 接口——那不是上手，是给自己挖坑。
为什么不用 WebClient 或 HttpClient 手动发 SOAP 请求
WebService（ASMX）本质是带 WSDL 描述的 SOAP 服务，手动拼 XML、设 Header、解析响应，极易出错：
-
Content-Type必须是text/xml; charset=utf-8，漏了 charset 就 500 - SOAP Action 头必须和 WSDL 中
soap:operation的soapAction完全一致，大小写敏感 - XML 命名空间、
soap:Envelope结构稍有偏差，服务端直接返回空响应或 400 - 没有类型映射，所有参数/返回值都得手动
XmlSerializer，字段名、嵌套层级一错就 null
除非你是在嵌入式环境或 .NET Core 旧版本里被迫降级，否则真没必要。
添加服务引用后，调用代码就三行
右键项目 → “添加服务引用” → 粘贴 WSDL 地址（如 http://example.com/Service.asmx?wsdl）→ 点确定。VS 自动生成代理类，比如叫 MyServiceSoapClient：
var client = new MyServiceSoapClient(); var result = client.GetData(123); // 方法名、参数类型、返回类型全部强类型 client.Close();
注意几点：
- 生成的类名默认基于 WSDL 中
service名，可在“添加服务引用”对话框底部改“命名空间” -
MyServiceSoapClient继承自System.ServiceModel.ClientBase<t></t>，不是Disposable，但必须调用Close()或Abort()，否则连接池耗尽 - 如果服务启用了 HTTPS 且证书不被信任，需在调用前加：
System.Net.ServicePointManager.ServerCertificateValidationCallback += (a, b, c, d) => true;（仅测试环境）
遇到“无法生成服务引用”时先查这三处
常见报错如“未能从远程服务器获取元数据”或“WSDL 导入失败”，别急着换工具，先确认：
- WSDL 地址末尾必须带
?wsdl，少一个问号就 404；如果是?WSDL（大写），IIS 可能拒绝（区分大小写） - 目标服务是否启用了 Windows 身份验证？VS 默认不带凭据，需在“添加服务引用”对话框点“高级”→ 勾选“允许使用 Windows 凭据”
- WSDL 内部引用了其他 XSD 或 WSDL（
xs:import），且这些地址不可达或需鉴权——此时应先用浏览器打开主 WSDL，搜索<import>，手动下载依赖文件，本地合并后再引用</import>
async 调用不是加个 await 就完事
VS 生成的代理默认只提供同步方法（GetData(123)）和基于 Begin/End 的异步（已过时）。要真正 async/await，得手动勾选：
- “添加服务引用” → “高级” → 勾选“生成异步操作” → 确定后会多出
GetDataAsync()方法 - 调用时必须
await，不能只写client.GetDataAsync(123)后不管，否则任务丢失、异常吞掉 - 若项目是 .NET Framework 4.5+，推荐用
Task.Run(() => client.GetData(123))包一层（简单场景够用）；真要高并发，还是得用GetDataAsync+ 正确异常处理
WSDL 解析和代理生成本身不支持增量更新，接口一变就得重新“添加服务引用”——这点容易被忽略，尤其当服务由第三方维护且文档滞后时，建议把生成的 Reference.cs 加进 Git，方便比对变更。
