WCF Web方法接收JSON参数时的Content-Type头问题

这种同一个服务里不同方法对JSON请求头支持不一致的情况，确实挺让人困惑的，我之前也碰到过类似的问题，大概率是方法配置或者序列化的细节没处理对，咱们来拆解下可能的原因和解决办法：

可能的原因 #

1. 方法的OperationContract配置缺失关键属性 #

那个异常的方法很可能没正确配置JSON序列化相关的属性，而正常运行的方法是加对了的。比如异常方法可能只加了[OperationContract]，但没指定请求格式为JSON；而正常方法额外加了[WebInvoke]来明确序列化规则。

举个例子，异常方法可能是这样的：

[OperationContract]
string ProblemMethod(MyCustomData data);

而正常的方法配置是：

[OperationContract]
[WebInvoke(RequestFormat = WebMessageFormat.Json, ResponseFormat = WebMessageFormat.Json)]
string WorkingMethod(MyCustomData data);

2. 参数类型的序列化配置不完整 #

如果异常方法的参数是自定义复杂类型，可能没给类型和成员加上[DataContract]、[DataMember]属性，导致WCF的JSON序列化器无法正确解析请求数据。而正常方法的参数要么是简单类型（比如string、int），要么是配置齐全的复杂类型。

3. 服务绑定/行为配置的差异 #

虽然是同一个服务，但两个方法有可能关联了不同的端点绑定？比如一个用了支持REST/JSON的webHttpBinding，另一个用了传统的basicHttpBinding（这种绑定默认不处理application/json头）。不过这种情况比较少见，但也得排查下。

对应的解决方案 #

1. 补全异常方法的WebInvoke属性 #

给异常的方法加上[WebInvoke]属性，明确指定请求格式为JSON，同时匹配客户端的请求方法（比如POST）：

[OperationContract]
[WebInvoke(Method = "POST", 
           RequestFormat = WebMessageFormat.Json, 
           ResponseFormat = WebMessageFormat.Json,
           UriTemplate = "/problem-method")]
string ProblemMethod(MyCustomData data);

这里的UriTemplate可以根据实际需求调整，确保客户端请求的路径和方法对应上。

2. 确保参数类型的序列化配置正确 #

如果参数是自定义类型，一定要给类型加上[DataContract]，并给需要序列化的成员加上[DataMember]：

[DataContract]
public class MyCustomData
{
    [DataMember]
    public string UserName { get; set; }
    
    [DataMember]
    public int UserId { get; set; }
}

这样WCF才能正确识别并解析请求中的JSON数据。

3. 验证服务的绑定和行为配置 #

在服务的配置文件（web.config/app.config）里，确认使用的是webHttpBinding，并且添加了webHttp行为（这个行为是处理REST风格请求的关键）：

<system.serviceModel>
  <behaviors>
    <endpointBehaviors>
      <behavior name="WebServiceBehavior">
        <webHttp />
      </behavior>
    </endpointBehaviors>
  </behaviors>
  <bindings>
    <webHttpBinding>
      <binding name="DefaultWebBinding" />
    </webHttpBinding>
  </bindings>
  <services>
    <service name="YourNamespace.YourService">
      <endpoint address="" 
                binding="webHttpBinding" 
                bindingConfiguration="DefaultWebBinding" 
                contract="YourNamespace.IYourService" 
                behaviorConfiguration="WebServiceBehavior" />
    </service>
  </services>
</system.serviceModel>

按照上面的步骤排查调整后，应该就能解决那个方法无法接受application/json请求头的问题了。

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