c# 怎么设置 http 代理

HttpClient需显式配置HttpClientHandler的Proxy属性才能走代理，自动读取系统或环境变量代理仅在未显式设置Proxy且UseProxy=true时生效；WebRequest.DefaultWebProxy对其无效。

HttpClient 如何配置全局代理

默认情况下 HttpClient 不走系统代理，也不自动读取环境变量（如 HTTP_PROXY），必须显式传入 HttpClientHandler 并设置其 Proxy 属性。

常见错误是直接 new HttpClient() 后试图通过其他方式“注入”代理——不行，代理必须在 handler 初始化时绑定。

• 使用 WebProxy 构造代理对象，支持用户名密码认证：

  var proxy = new WebProxy("http://127.0.0.1:8888") {
      Credentials = new NetworkCredential("user", "pass")
  };

• 创建 HttpClientHandler 并赋值：

  var handler = new HttpClientHandler {
      Proxy = proxy,
      UseProxy = true
  };

• 再用该 handler 构造 HttpClient：

  var client = new HttpClient(handler);

• 注意：如果目标地址是 localhost 或 127.0.0.1，默认会被绕过代理（BypassProxyOnLocal = true），需手动关掉：

  handler.Proxy = proxy;
  handler.UseProxy = true;
  handler.BypassProxyOnLocal = false;

如何让 HttpClient 自动读取系统或环境变量代理

.NET 5+ 支持自动从操作系统或环境变量加载代理，但仅当未显式设置 Proxy 且 UseProxy = true（默认值）时生效。

关键点：不能 new WebProxy，也不能赋值 handler.Proxy，否则自动探测逻辑被跳过。

• 启用自动代理探测（Windows）：

  var handler = new HttpClientHandler {
      UseProxy = true, // 必须为 true（默认就是 true）
      // Proxy = null（不要设！）
  };

• Linux/macOS 下会检查 HTTP_PROXY、HTTPS_PROXY、NO_PROXY 环境变量
• 若需强制走环境变量且忽略系统设置，可手动解析：

  var proxyUri = Environment.GetEnvironmentVariable("HTTP_PROXY");
  if (!string.IsNullOrEmpty(proxyUri)) {
      handler.Proxy = new WebProxy(proxyUri);
  }

WebRequest.DefaultWebProxy 的影响范围

WebRequest.DefaultWebProxy 是 .NET Framework 时代的全局代理设置，对 HttpClient 完全无效（除非你用的是基于 HttpWebRequest 的旧实现）。

它只影响：

• HttpWebRequest 实例（已过时）
• 部分老 SDK（如早期 Azure Storage SDK v9）
• WebClient（同样不推荐新项目使用）

所以不要写：

WebRequest.DefaultWebProxy =
 new WebProxy("...");

这不会让 HttpClient 变成走代理——纯属无效操作。

代理认证失败的典型表现和调试方法

407 Proxy Authentication Required 是最常遇到的错误，但异常堆栈往往不直接暴露原因，容易误判为服务端问题。

• 确认 Credentials 类型：如果代理要求 NTLM，得用 CredentialCache.DefaultCredentials；Basic 认证才用 NetworkCredential
• 检查是否漏设 UseProxy = true：即使给了 Proxy，若 UseProxy 是 false，handler 会静默忽略代理
• 抓包验证：用 Fiddler 或 Wireshark 看实际 CONNECT 请求头是否含 Proxy-Authorization
• 临时关闭认证测试连通性：

  var proxy = new WebProxy("http://127.0.0.1:8888") {
      UseDefaultCredentials = false, // 关键：避免 Windows 凭据干扰
      Credentials = null
  };

代理配置不是“设了就通”，每个环节（handler 创建时机、UseProxy 开关、BypassProxyOnLocal、认证方式）都可能单独导致失败。最稳妥的做法是：始终显式构造 WebProxy + HttpClientHandler，不依赖自动探测，尤其在容器或 CI 环境中。