.NET Core 下调用 WCF 服务的 WebHttpBinding 实现方案咨询

.NET Core / .NET 5+ 官方提供的 WCF 客户端依赖库（System.ServiceModel.* 系列）原生没有内置 WebHttpBinding 实现，可根据业务场景选择以下两种方案落地：

1. 通用场景：用 HttpClient 直接替代 #

WebHttpBinding 本质是 WCF 封装的 REST 风格 HTTP 调用约定，90%以上的场景可以直接用 HttpClient 实现，完全不需要依赖 WCF 相关库，改造成本更低。

• 原有 WebHttpBinding 配置和 HttpClient 配置映射关系：
  • 服务地址：对应 HttpClient.BaseAddress
  • 超时时间：对应 HttpClient.Timeout
  • 最大响应消息大小：对应 HttpClient.MaxResponseContentBufferSize
  • 身份认证：通过 HttpClient.DefaultRequestHeaders.Authorization 配置 Basic、Digest 等认证逻辑
  • 消息格式（JSON/XML）：通过请求头 Accept、Content-Type 声明

代码示例：

// 推荐在DI容器中注册IHttpClientFactory获取实例，避免端口耗尽问题
var httpClient = new HttpClient
{
    BaseAddress = new Uri("http://你的WCF服务根地址/"),
    Timeout = TimeSpan.FromSeconds(30)
};
// 匹配原有WebHttpBinding的JSON格式约定
httpClient.DefaultRequestHeaders.Accept.Add(new System.Net.Http.Headers.MediaTypeWithQualityHeaderValue("application/json"));

// 调用原WCF服务中标记 [WebGet(UriTemplate = "GetUserInfo?userId={userId}")] 的接口
var response = await httpClient.GetAsync($"GetUserInfo?userId=1001");
response.EnsureSuccessStatusCode();
// 反序列化响应结果，和原有业务实体共用即可
var userInfo = await response.Content.ReadFromJsonAsync<UserInfo>();

如果是调用标记了 [WebInvoke(Method = "POST")] 的接口，改用 PostAsJsonAsync 方法即可。

2. 强绑定WCF约定场景：自定义绑定模拟WebHttpBinding #

如果业务代码强依赖原有WCF服务接口契约，不想大量修改业务调用逻辑，可以通过 CustomBinding 手动拼接绑定元素实现等效功能：

• 第一步：安装所需NuGet包：System.ServiceModel.Http、System.ServiceModel.Primitives、System.ServiceModel.Web
• 第二步：构造自定义绑定并初始化客户端：

// 构造自定义绑定，等效于WebHttpBinding
var binding = new CustomBinding();
// 添加Web消息编码元素，匹配服务端的编码格式约定
binding.Elements.Add(new WebMessageEncodingBindingElement
{
    WriteEncoding = Encoding.UTF8
});
// 添加HTTP传输元素，匹配原有配置的传输参数
binding.Elements.Add(new HttpTransportBindingElement
{
    MaxReceivedMessageSize = 10 * 1024 * 1024, // 10MB最大消息大小
    TransferMode = TransferMode.Buffered
});

// 初始化通道工厂，传入原有服务契约接口
var channelFactory = new ChannelFactory<IMyWcfServiceContract>(binding, new EndpointAddress("http://你的WCF服务地址"));
// 添加WebHttp行为，匹配服务端的消息格式约定
channelFactory.Endpoint.EndpointBehaviors.Add(new WebHttpBehavior
{
    DefaultOutgoingRequestFormat = WebMessageFormat.Json,
    DefaultIncomingResponseFormat = WebMessageFormat.Json,
    AutomaticFormatSelectionEnabled = true
});

// 创建客户端代理，直接调用原有接口方法即可
var serviceClient = channelFactory.CreateChannel();
var result = serviceClient.GetUserInfo(1001);

原BasicHttpBinding/CustomBinding报错排查 #

• 确认服务端协议类型：BasicHttpBinding 仅适用于SOAP 1.1协议的WCF服务，REST风格的WCF服务不要使用该绑定
• 检查绑定参数：如果服务端开启了认证、HTTPS、消息签名等配置，需要在客户端绑定中同步对应配置，否则会抛出协议不匹配错误

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