.NET中基于WSDL的WebService<xs>标签转<s>及客户端WSDL咨询

我之前在对接第三方WebService时也碰到过一模一样的问题——.NET工具生成的代理类居然把WSDL里的<xs>标签全都换成了<s>，导致服务端直接返回解析错误。结合你给出的WSDL片段，我来分享下解决思路和具体方案：

首先先确认你提供的WSDL片段里的命名空间声明是正确的：

<?xml version='1.0' encoding='UTF-8'?>
<wsdl:definitions xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/" xmlns:tns="http://example.com/" xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/" xmlns:ns1="http://schemas.xmlsoap.org/soap/http" name="PersonInfoTransactionService" targetNamespace="http://example.com/"> 
  <wsdl:types> 
    <xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema...

问题根源 #

这其实是.NET自带的WSDL处理工具（比如wsdl.exe或者Visual Studio的「添加服务引用」）的默认行为：它会把http://www.w3.org/2001/XMLSchema这个标准XMLSchema命名空间的前缀默认替换为s，而不是保留WSDL里原有的xs。如果服务端对XML前缀有严格校验，就会触发异常。

具体解决方案 #

1. 手动修改生成的代理类代码

这是最直接的办法。生成代理类后，搜索所有带有s前缀的XML序列化属性，手动添加Prefix = "xs"参数：
比如原来的代码可能是这样：

[XmlElement(Namespace = "http://www.w3.org/2001/XMLSchema", ElementName = "PersonID")]
public string PersonID { get; set; }

改成：

[XmlElement(Namespace = "http://www.w3.org/2001/XMLSchema", ElementName = "PersonID", Prefix = "xs")]
public string PersonID { get; set; }

注意要把所有涉及该命名空间的属性都修改到位，包括XmlAttribute、XmlArray等序列化特性。

2. 用SvcUtil工具强制指定前缀

如果不想手动改代码，可以在生成代理类时就指定命名空间前缀。打开命令提示符，运行以下命令：

svcutil.exe /namespace:http://www.w3.org/2001/XMLSchema,xs YourService.wsdl

这个命令会告诉SvcUtil，把http://www.w3.org/2001/XMLSchema命名空间的前缀固定为xs，生成的代理类就会直接使用<xs>标签。

3. 自定义XML序列化逻辑

如果上面两种方法都不适用（比如代理类需要自动更新），可以在调用WebService时使用自定义的XmlSerializerNamespaces来指定前缀：

// 创建命名空间映射，指定xs前缀
XmlSerializerNamespaces namespaces = new XmlSerializerNamespaces();
namespaces.Add("xs", "http://www.w3.org/2001/XMLSchema");

// 获取WebService的请求对象
var request = new PersonInfoRequest();
// 填充请求数据...

// 手动序列化请求（如果是自己处理请求发送的话）
var serializer = new XmlSerializer(typeof(PersonInfoRequest));
using (var stream = new MemoryStream())
{
    serializer.Serialize(stream, request, namespaces);
    // 把stream里的内容作为请求发送给服务端
}

如果是使用自动生成的代理类，有些版本可以通过修改客户端绑定的MessageEncoding配置，或者自定义IClientMessageFormatter来注入这个命名空间配置。

额外提醒 #

如果你是用Visual Studio的「添加服务引用」功能，也可以尝试点击「高级」按钮，查看是否有「命名空间前缀」相关的配置项（部分VS版本支持自定义前缀映射），这样生成的代理类会直接符合要求。

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