为什么.NET中HttpClient设置的NetworkCredential未出现在请求头中？

原因说明 #

1. 为什么NetworkCredential配置看似不生效 #

HttpClientHandler的Credentials属性默认遵循质询-响应的认证流程：

• 首次发送请求时不会主动携带Authorization头，先发送匿名请求
• 只有当服务端返回401 Unauthorized状态码，且响应头包含WWW-Authenticate: Basic字段，明确告知客户端需要使用Basic认证时，HttpClientHandler才会自动将NetworkCredential中的账号密码编码为Basic认证头，重新发起请求

你自己实现的Basic认证逻辑中，检测到没有Authorization头直接抛出异常，没有正确返回带WWW-Authenticate头的401响应，客户端就不会触发自动补充认证头的逻辑，因此看起来配置不生效。你调用的第三方API在返回401时会携带正确的质询头，所以相同配置可以正常工作。

2. 为什么手动加头代码可以生效 #

手动给DefaultRequestHeaders添加Authorization头的逻辑，相当于跳过了质询流程，首次请求就直接携带认证信息，因此可以直接通过服务端的校验逻辑。

适配修改方案 #

只需修改你自定义的BasicAuthenticationHandler的无认证头处理逻辑，返回符合标准的质询响应即可：

public class BasicAuthenticationHandler : AuthenticationHandler<AuthenticationSchemeOptions>
{
    protected override async Task<AuthenticateResult> HandleAuthenticateAsync()
    {
        // ... 原有其他逻辑

        if (!Request.Headers.TryGetValue("Authorization", out StringValues authHeaderValues))
        {
            // 新增：添加Basic认证质询头，realm可以替换为你的API标识
            Response.Headers["WWW-Authenticate"] = "Basic realm=\"你的API服务标识\"";
            // 不要直接抛异常，返回认证失败结果，框架会自动生成401响应
            return AuthenticateResult.Fail("Missing Authorization header");
        }

        // ... 原有后续校验逻辑
    }
}

额外可选优化：如果你希望客户端在第一次请求时就主动携带认证头，无需走质询流程，可以在客户端配置HttpClientHandler时开启PreAuthenticate属性：

.ConfigurePrimaryHttpMessageHandler(serviceProvider =>
{
    return new HttpClientHandler()
    {
        Credentials = new NetworkCredential(settings.Username, settings.Password),
        PreAuthenticate = true // 首次请求就携带认证头
    };
});

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