代理环境变量没有生效怎么办

Go 的 net/http 默认传输层会读取 HTTP_PROXY、HTTPS_PROXY 和 NO_PROXY。代理环境变量没有生效时，先不要急着改请求代码：最常见的原因是变量没有进入 Go 进程、请求协议匹配错了、目标命中了 NO_PROXY，或者自定义 Transport 已经替换了默认代理函数。

先确认 Go 进程实际看到了哪些变量

终端里能执行 echo $HTTPS_PROXY，不代表 IDE、systemd、容器或 CI 启动的 Go 进程也能看到它。第一步应在程序内部打印变量是否存在，再用同一个请求调用 http.ProxyFromEnvironment 做判断。下面的示例只输出代理地址的主机和端口，避免把代理认证信息写进日志。

package main

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

func main() {
	for _, key := range []string{"HTTP_PROXY", "HTTPS_PROXY", "NO_PROXY"} {
		// 先确认变量进入了当前 Go 进程，而不是只存在于父级终端。
		fmt.Printf("%s=%q\n", key, os.Getenv(key))
	}

	req, err := http.NewRequest(http.MethodGet, "https://api.example.test/health", nil)
	if err != nil {
		// 请求地址不合法时先结束，避免把代理问题误判成网络问题。
		panic(err)
	}
	proxy, err := http.ProxyFromEnvironment(req)
	if err != nil {
		// 代理值不是合法 URL 或 host:port 时，直接记录解析错误。
		panic(err)
	}
	if proxy == nil {
		fmt.Println("proxy=")
		return
	}
	// 只保留 scheme、host 和 port，不把用户名密码写入日志。
	safe := &url.URL{Scheme: proxy.Scheme, Host: proxy.Host}
	fmt.Printf("proxy=%s\n", safe.String())
}

如果这里已经得到 proxy=，说明问题发生在匹配阶段，而不是后面的 TCP 连接。若变量打印为空，检查启动器的导出方式：macOS/ Linux shell 需要 export，容器需要在运行配置中注入，systemd 则应放在服务的 Environment= 或 EnvironmentFile= 中。

按请求协议和 NO_PROXY 逐项判断

HTTP_PROXY 对应 HTTP 请求，HTTPS_PROXY 对应 HTTPS 请求；变量值可以写完整 URL，也可以写 host:port，后者按 HTTP 代理解释。不要只设置一个变量就假定两种协议都会走同一条路径，尤其要检查实际请求 URL 的 scheme。

接着检查 NO_PROXY。它是逗号分隔的排除列表，可以包含主机、域名、IP 前缀、CIDR 或端口限定。目标命中后，ProxyFromEnvironment 会返回空代理；localhost（含端口）也有明确的直连特殊处理。因此“外网走代理、内网直连”往往是配置结果，不是代理失效。

自定义 Transport 会覆盖默认代理行为

http.Get 和默认 http.Client 使用的是 http.DefaultTransport，它的 Proxy 默认值是 http.ProxyFromEnvironment。但只要代码创建了新的 http.Transport，就不能再假设环境变量会自动接管。典型误区是设置了超时、TLS 或连接池参数后顺手创建 Transport，却没有补上 Proxy 字段。

package main

import (
	"context"
	"fmt"
	"net/http"
	"net/url"
	"time"
)

func main() {
	proxyURL, err := url.Parse("http://proxy.example.test:8080")
	if err != nil {
		// 生产配置应在启动时失败，不能带着半套网络配置继续运行。
		panic(err)
	}

	transport := &http.Transport{
		// 显式指定代理，避免自定义 Transport 把默认环境代理覆盖掉。
		Proxy: http.ProxyURL(proxyURL),
	}
	client := &http.Client{Transport: transport, Timeout: 8 * time.Second}

	ctx, cancel := context.WithTimeout(context.Background(), 5*time.Second)
	defer cancel() // 请求结束后释放上下文计时器。
	req, err := http.NewRequestWithContext(ctx, http.MethodGet, "https://api.example.test/health", nil)
	if err != nil {
		panic(err)
	}
	resp, err := client.Do(req)
	if err != nil {
		// 这里的错误表示连接或代理链路失败，不等同于“变量没有生效”。
		panic(err)
	}
	defer resp.Body.Close() // 关闭响应体，允许连接回收到连接池。
	fmt.Println(resp.StatusCode)
}

如果希望继续使用环境变量，改成 Proxy: http.ProxyFromEnvironment；如果想完全禁用代理，显式保留 Proxy 为 nil，并把这个选择写进配置说明。不要在同一个客户端里一会儿依赖环境变量、一会儿动态替换 Transport，这会让排障结果难以复现。

把配置放在进程启动阶段并做最后检查

Go 的默认代理函数会缓存从环境构造出的代理配置。把 os.Setenv 放在第一次网络请求之后，可能已经错过了读取时机；更稳妥的做法是在 shell、容器编排或服务管理器中注入变量，程序启动后只读配置。若必须在程序内切换代理，创建一个新的 Transport，并用 http.ProxyURL 或自定义代理函数明确表达切换。

发布前按这个顺序排查：一是确认变量在目标进程内非空；二是确认请求的 http/https 与变量对应；三是临时缩小 NO_PROXY；四是检查是否创建了自定义 Transport；五是用上面的诊断代码确认返回的是代理 URL 还是直连。这样能把“代理服务器不可达”和“Go 根本没有选择代理”分开处理。

常见问题

为什么设置了 HTTPS_PROXY，localhost 仍然直连？

这是 Go net/http 对 localhost 的特殊处理，环境代理不是对所有主机强制生效。测试代理链路时应使用可路由的测试域名，或者在 Transport 中使用明确的代理策略。

为什么复制同一份环境变量到代码里仍然不生效？

优先检查请求是否使用了自定义 Transport。环境变量只会影响使用 ProxyFromEnvironment 的代理函数；Transport 的 Proxy 被置空或被其他函数替换时，变量本身没有机会参与决策。

参考：Go net/http 的 ProxyFromEnvironment、DefaultTransport 与传输层源码，https://pkg.go.dev/net/http。