WCF基本身份验证配置异常：添加服务引用触发System.NotSupportedException

这个错误我之前帮不少开发者踩过坑，核心就是你的WCF服务绑定要求用Basic身份认证，但宿主（比如IIS）只开了匿名认证，再加上绑定的SecurityMode可能没配置对，导致两者直接冲突。下面一步步来修复：

1. 先把WCF绑定的SecurityMode配置弄对 #

首先得确保你的BasicHttpBinding明确指定了SecurityMode，并且把认证方式设为Basic。分两种情况：

• 如果是用HTTP协议：选TransportCredentialOnly（Transport是给HTTPS用的）
• 如果是HTTPS协议：选Transport

配置文件版（web.config）： #

<system.serviceModel>
  <bindings>
    <basicHttpBinding>
      <binding name="BasicAuthEnabledBinding">
        <security mode="TransportCredentialOnly"> <!-- HTTP用这个，HTTPS换Transport -->
          <transport clientCredentialType="Basic" />
        </security>
      </binding>
    </basicHttpBinding>
  </bindings>
  <services>
    <service name="YourServiceNamespace.YourServiceClass">
      <endpoint address="" 
                binding="basicHttpBinding" 
                bindingConfiguration="BasicAuthEnabledBinding" 
                contract="YourServiceNamespace.IYourServiceContract" />
    </service>
  </services>
</system.serviceModel>

代码配置版（自托管场景）： #

var basicBinding = new BasicHttpBinding();
// 根据协议选对应的SecurityMode
basicBinding.Security.Mode = BasicHttpSecurityMode.TransportCredentialOnly; 
basicBinding.Security.Transport.ClientCredentialType = HttpClientCredentialType.Basic;

// 后续绑定到ServiceHost
var host = new ServiceHost(typeof(YourServiceClass));
host.AddServiceEndpoint(typeof(IYourServiceContract), basicBinding, "http://localhost:8080/YourService");

2. 给宿主开启Basic认证，关掉匿名认证 #

这一步最容易忘！以IIS为例：

• 打开IIS管理器，找到你的WCF服务站点/应用
• 点击认证功能（在IIS区域里）
• 右键匿名认证 → 选禁用（别让它干扰Basic认证）
• 右键基本认证 → 选启用

如果是自托管服务，还得加个用户名密码验证器，不然服务不知道怎么验证账号：

// 自定义验证逻辑，继承UserNamePasswordValidator
public class CustomAuthValidator : UserNamePasswordValidator
{
    public override void Validate(string userName, string password)
    {
        // 这里写你的验证逻辑，比如查数据库、对比硬编码账号等
        if (userName != "admin" || password != "123456")
        {
            throw new FaultException("用户名或密码错误");
        }
    }
}

// 加到ServiceHost的行为里
var serviceCreds = new ServiceCredentials();
serviceCreds.UserNameAuthentication.UserNamePasswordValidationMode = UserNamePasswordValidationMode.Custom;
serviceCreds.UserNameAuthentication.CustomUserNamePasswordValidator = new CustomAuthValidator();

host.Description.Behaviors.Remove<ServiceCredentials>();
host.Description.Behaviors.Add(serviceCreds);

3. 客户端（添加服务引用后）的配置检查 #

添加服务引用后，VS会自动生成客户端配置，但有时候会有偏差，手动检查app.config/web.config里的绑定：

<system.serviceModel>
  <bindings>
    <basicHttpBinding>
      <binding name="BasicAuthEnabledBinding">
        <security mode="TransportCredentialOnly"> <!-- 和服务端保持一致 -->
          <transport clientCredentialType="Basic" />
        </security>
      </binding>
    </basicHttpBinding>
  </bindings>
  <client>
    <endpoint address="http://your-service-url/YourService.svc" 
              binding="basicHttpBinding" 
              bindingConfiguration="BasicAuthEnabledBinding" 
              contract="YourServiceReference.IYourServiceContract" />
  </client>
</system.serviceModel>

调用服务时别忘了传凭据：

using (var client = new YourServiceReference.YourServiceClient())
{
    client.ClientCredentials.UserName.UserName = "admin";
    client.ClientCredentials.UserName.Password = "123456";
    // 调用服务方法
    var result = client.YourServiceMethod();
}

几个容易踩的小坑 #

• 用HTTPS的话，IIS必须配好有效的SSL证书，不然Transport模式会报错
• 别同时开匿名和Basic认证，IIS会优先用匿名，导致绑定的Basic要求不生效
• 自托管服务要确保防火墙开了对应的端口，不然客户端连不上

内容的提问来源于stack exchange，提问作者A.Pissicat