结论：优先用 visual studio 的“添加服务引用”（或 vs 2005/2008 的“添加 web 引用”），它依 wsdl 自动生成强类型客户端，自动处理命名空间、soapaction、xsi:nil、编码及http头等易错细节，是.net framework 2.0–4.8环境下最稳定可靠的方式。
直接说结论：别手写 SOAP XML，优先用 Visual Studio 的“添加服务引用”（Add Service Reference）。它能自动生成强类型客户端类，省去拼接命名空间、处理 xsi:nil、管理 SOAPAction 头等所有易错环节——尤其在 .NET Framework 2.0–4.8 环境下（比如 VS 2005/2008/2010 项目），这是最稳、最省事、也最符合 WSDL 合约的方式。
为什么“添加服务引用”比手写 XML 更可靠
手写 SOAP 请求看似灵活，但实际踩坑极多：xmlns 前缀不匹配、SOAPAction 值与 WSDL 中的 operation 不一致、xsi:nil="true" 位置或格式错误、编码未设为 UTF-8、HTTP 头缺失或冲突……这些都会导致 500、400 或空响应。而“添加服务引用”会严格按 WSDL 解析出：
- 每个方法对应的请求/响应类结构
- 正确的命名空间 URI 和前缀绑定
- 自动生成的 SOAPAction 值（藏在生成的 Reference.cs 里）
- 对 null 参数自动注入 xsi:nil="true"（只要你在 C# 里传 null，且参数类型是可空引用或 Nullable<t></t>）
- 内置超时、凭证、代理设置入口
VS 2005/2008 中“添加 Web 引用”的关键操作点
注意：VS 2005 默认用的是旧版“添加 Web 引用”（Add Web Reference），不是后来的“添加服务引用”。两者生成代码风格不同，但都可用：
- 右键项目 → “添加 Web 引用”，输入 WSDL 地址（如 http://example.com/Service.asmx?wsdl）
- 如果提示“无法下载”，先用浏览器打开该地址，确认能返回 XML 格式的 WSDL
- 命名空间建议用有意义的短名（如 CustomerSvc），不要留空或用默认 localhost
- 生成后，检查 Reference.cs 中是否包含你目标方法（如 GetCustomerInfo），以及参数类型是否含 string、int? 等可空类型
- 调用时直接 new 客户端类，例如：var client = new CustomerSvc.CustomerService(); var result = client.GetCustomerInfo("C123");
手写 SOAP 请求时必须校验的 4 个头和内容项
只有在无法获取 WSDL（如对方只给 endpoint URL 和文档说明）或需绕过代理限制时，才考虑手写。此时务必核对：
- Content-Type 必须是 "text/xml; charset=utf-8"，不能写成 "application/soap+xml"（那是 WS-* 2.0+）
- SOAPAction 头值必须与 WSDL 中对应 <operation></operation> 的 soap:action 属性完全一致（包括末尾斜杠、大小写）
- XML 请求体中的根元素名（如 <getcustomerinfo></getcustomerinfo>）和命名空间（xmlns="http://tempuri.org/"）必须与 WSDL 的 <message></message> 和 <porttype></porttype> 定义对齐
- 若传 null，需显式写出 <customerid xsi:nil="true"></customerid>，且确保已声明 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
常见错误：Received an invalid header line: 'Cache-Control'
这个错误几乎总是因为手动调用 HttpClient 时误设了 request.Headers.CacheControl。SOAP 协议不依赖 HTTP 缓存控制，服务器通常拒绝带 Cache-Control 的请求头。解决办法很简单：
- 不要碰 request.Headers.CacheControl
- 不要调用 request.Headers.Clear()（它会删掉 Content-Type 等必要头）
- 改用 request.Headers.TryAddWithoutValidation("SOAPAction", "...") 避免验证逻辑干扰
- 或者更干脆：换回 HttpWebRequest，它对 SOAP 头更宽容
真正麻烦的从来不是发出去，而是发出去之后服务器怎么解释那个 XML —— 所以别跟命名空间和 nil 属性较劲，让工具替你做。如果 WSDL 可用，就别自己造轮子；如果 WSDL 不可用，至少拿 Fiddler 抓一个真实成功请求的完整 HTTP 流量，逐字节对齐。
