调用API偶发401错误，服务商称HTTPS请求缺失用户名密码，代码是否有问题？

偶发401问题根因排查 #

你的代码没有明显语法错误，偶发无凭证的问题基本都和HttpClientHandler内置的凭证处理隐性逻辑有关，常见触发场景如下：

• 默认不会主动随首次请求发凭证：HttpClientHandler默认先发送不带凭证的请求，只有当服务端返回401且携带合法WWW-Authenticate响应头时，才会重试带凭证的请求。如果服务端偶发未返回该头、或是请求被中间代理/CDN拦截直接返回无该头的401，Handler就会直接返回401，刚好符合服务商观测到的「请求未带凭证」特征。
• 未开启预验证导致重复触发无凭证请求：HttpClientHandler的PreAuthenticate属性默认值为false，每次请求新路径都会重新走「先发无凭证请求再重试」的流程。如果你的请求路径参数变化频繁、或是服务端认证缓存过期，就会偶发遇到无凭证请求直接被返回401的情况。
• 重定向丢凭证：如果API存在偶发的跨域名/跨子域名重定向逻辑，NetworkCredential默认不会将凭证发送给原始域名外的地址，重定向后的请求就会无凭证返回401。
• 配置读取偶发失效：如果Settings.Username和Settings.Password是懒加载、或是配置读取逻辑非线程安全，可能在类构造时偶发读取到空值，导致初始化的credentials实际为空。
• 并发修改共享实例：HttpClient和HttpClientHandler都不是线程安全的，如果你在多线程场景下修改两个实例的属性，可能偶发导致配置被重置、凭证丢失。

修复方案 #

优先选择手动加认证头的方案，完全规避Handler自动处理凭证的隐性问题：

// 构造函数中直接把认证头加入默认请求头，每次请求都会自动携带
var credentialBytes = Encoding.ASCII.GetBytes($"{Settings.Username}:{Settings.Password}");
var base64Credential = Convert.ToBase64String(credentialBytes);
HttpClient.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Basic", base64Credential);
// 无需再给Handler设置Credentials
HttpClientHandler = new HttpClientHandler();
HttpClient = new HttpClient(HttpClientHandler);

如果要保留Credentials的实现方式，修改Handler配置即可：

NetworkCredential credentials = new(Settings.Username, Settings.Password);
HttpClientHandler = new HttpClientHandler {
    Credentials = credentials,
    PreAuthenticate = true, // 开启预验证，首次验证通过后后续请求直接带凭证
    UseDefaultCredentials = false, // 禁用系统默认凭证，避免自定义凭证被覆盖
    // 不需要自动重定向可加下一行，避免重定向丢凭证
    // AllowAutoRedirect = false
};
HttpClient = new HttpClient(HttpClientHandler);

额外优化建议：

• 确保HttpClient为全局单例，不要每次请求都新建实例，减少重复认证频次
• 类实例构造前确认Settings配置已加载完成，避免读取到空的账号密码

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