Go HTTP 客户端代理环境变量为什么没有生效

Go HTTP 客户端代理环境变量没有生效，最常见的原因不是 HTTP_PROXY 拼写，而是请求没有使用带代理函数的 DefaultTransport，或者程序第一次解析代理后才修改了环境变量。http.Client{} 在 Transport 为 nil 时才会回落到 http.DefaultTransport；一旦自己创建了 http.Transport，就要明确设置 Proxy。

排查顺序应是：先确认 Client 实际使用的 Transport，再按 URL 协议检查变量，最后调用 http.ProxyFromEnvironment 看它对这一个请求返回了什么。环境变量要在首次代理解析前设置，修改后不要期待已经初始化的代理配置自动刷新。

1. 先确认请求是不是走 DefaultTransport

标准库的默认链路是 http.DefaultClient 使用 nil Transport，最终落到 http.DefaultTransport；后者的 Proxy 字段才预置为 http.ProxyFromEnvironment。因此下面的写法通常能读到环境代理：

package main

import "net/http"

func main() {
	client := &http.Client{}
	// Transport 为 nil 时，Client 使用 DefaultTransport，其中包含环境代理函数。
	_, _ = client.Get("https://api.example.com/health")
}

而 &http.Client{Transport: &http.Transport{}} 已经换掉默认 Transport。这个空 Transport 的 Proxy 是 nil，直连是预期行为。包装第三方 RoundTripper 时也要检查它内部最终调用的是否是默认 Transport。

当你设置了HTTP_PROXY、HTTPS_PROXY这类环境变量之后Go的HTTP客户端没走代理，大概率是这几类原因：手动自定义了http.Transport且没有把Proxy字段留空、程序运行时读取到的进程环境变量和你当前终端设置的不一致、走了内网目标地址命中了NO_PROXY的排除规则、Go版本对应的标准库代理逻辑有特殊边界判定。

2. 按 URL 协议核对三个环境变量

ProxyFromEnvironment 会根据请求协议选择变量：http:// 请求看 HTTP_PROXY，https:// 请求看 HTTPS_PROXY；NO_PROXY 匹配目标主机时返回 nil。代理值可以写完整 URL，也可以写 host:port，后者按 HTTP 代理地址处理。localhost 是标准库明确的特殊绕过场景。

3. 不发网络请求，直接打印代理解析结果

先用同一个目标 URL 构造请求，再调用代理函数。这个检查只解析配置，不连接代理服务器，适合放进启动诊断或单元测试：

package main

import (
	"fmt"
	"net/http"
)

func main() {
	req, err := http.NewRequest(http.MethodGet, "https://api.example.com/health", nil)
	if err != nil {
		panic(err) // URL 解析失败时停止，避免用错误目标继续判断代理。
	}

	proxyURL, err := http.ProxyFromEnvironment(req)
	if err != nil {
		panic(err) // 代理变量格式错误时，先修正 URL 或 host:port 写法。
	}
	if proxyURL == nil {
		fmt.Println("proxy=none") // 可能是变量未设置，也可能是 NO_PROXY 或 localhost 命中。
		return
	}
	fmt.Println("proxy=", proxyURL.Redacted()) // Redacted 避免把代理密码写进日志。
}

如果这里返回了代理 URL，而实际请求仍直连，问题就不在环境变量，而在 Client、Transport 或第三方库的请求通道。反过来，如果这里返回 nil，先修协议变量、NO_PROXY 或设置时机，不要盲目调超时。

4. 修复自定义 Transport 的代理覆盖

需要保留默认连接池、TLS 和 HTTP/2 等默认行为时，优先克隆默认 Transport，再覆盖少量字段。若业务必须固定代理，也可以显式使用 ProxyURL：

package main

import (
	"net/http"
	"net/url"
)

func clientFromEnvironment() *http.Client {
	base := http.DefaultTransport.(*http.Transport).Clone()
	// Clone 保留默认 Transport 的其他字段，只把代理决策明确绑定到环境变量。
	base.Proxy = http.ProxyFromEnvironment
	return &http.Client{Transport: base}
}

func clientWithFixedProxy() (*http.Client, error) {
	proxyURL, err := url.Parse("http://proxy.example:8080")
	if err != nil {
		return nil, err // 固定代理地址不可解析时，不创建半配置 Client。
	}
	transport := http.DefaultTransport.(*http.Transport).Clone()
	transport.Proxy = http.ProxyURL(proxyURL)
	return &http.Client{Transport: transport}, nil
}

不要修改全局 http.DefaultTransport 的字段来“临时试一下”，尤其是程序已经并发发请求时。把 Transport 作为一个明确的依赖传入，更容易区分环境代理、固定代理和完全直连三种策略。

5. 把设置时机放在首次解析之前

当前 Go 源码用一次性初始化保存环境代理函数。实际应用中最稳妥的做法是由进程启动环境提供变量，或在创建 Client、发出任何请求之前完成 os.Setenv。如果程序已经发过请求，后来才改 HTTP_PROXY，应重启进程或创建新的、明确配置的 Transport，并重新做上面的无网络探测。

最后按这张清单复查：目标 URL 是 HTTP 还是 HTTPS；对应变量是否有值；NO_PROXY 是否命中；Client 的 Transport 是否为 nil 或来自默认 Transport；自定义 Transport 的 Proxy 是否为 nil；代理值是否能被解析；代理配置是否在首次请求前就确定。

相关问题

为什么设置了 HTTP_PROXY，HTTPS 请求还是直连？

因为 HTTPS 请求优先检查 HTTPS_PROXY，只设置 HTTP_PROXY 不足以覆盖两个协议。

NO_PROXY 为空但 localhost 仍然不走代理，正常吗？

正常。ProxyFromEnvironment 对 localhost 有特殊绕过规则，不能用 localhost 请求判断外网代理是否生效。

把 Proxy 设置成 nil 能否关闭代理？

可以，但这表示该 Transport 不询问代理；若要按环境变量决定，应设置为 http.ProxyFromEnvironment。