如何在 Go 中正确获取当前 HTTP 请求的协议方案（HTTP/HTTPS）-Golang-PHP中文网

如何在 Go 中正确获取当前 HTTP 请求的协议方案（HTTP/HTTPS）

Go 的 http.Request.URL.Scheme 始终为空，因为标准 HTTP 服务器不从客户端解析并填充该字段；需通过检查 r.TLS != nil 判断是否为 HTTPS 请求，并结合监听端口与反向代理场景综合推断 scheme。

go 的 `http.request.url.scheme` 始终为空，因为标准 http 服务器不从客户端解析并填充该字段；需通过检查 `r.tls != nil` 判断是否为 https 请求，并结合监听端口与反向代理场景综合推断 scheme。

在 Go 的标准 net/http 包中，r.URL.Scheme 字段不会自动设置为 "http" 或 "https"——它通常为空字符串（""）。这是因为 http.Request 的 URL 是由服务器根据请求行和 Host 头解析而来，而原始 HTTP/1.1 协议本身不强制传输 scheme；scheme 是应用层语义，需由服务端根据实际通信上下文推断。

✅ 正确判断 scheme 的方法

1. 基于 TLS 状态（适用于直连 HTTPS 服务）

最直接可靠的依据是 r.TLS 字段：

若 r.TLS != nil → 请求经 TLS 加密 → scheme 为 "https"
若 r.TLS == nil → 未使用 TLS → scheme 通常为 "http"

func handler(w http.ResponseWriter, r *http.Request) {
    scheme := "http"
    if r.TLS != nil {
        scheme = "https"
    }
    fmt.Fprintf(w, "Scheme: %s\n", scheme)
}

⚠️ 注意：此方式仅在服务端同时启用 HTTP 和 HTTPS 监听时才具备区分意义。若只运行 http.ListenAndServe(":8080", nil)，所有请求 r.TLS 恒为 nil，此时 scheme 必然为 "http"；同理，若仅运行 http.ListenAndServeTLS(":8443", ...)，则 r.TLS 恒非空，scheme 必然为 "https"。

2. 启动双协议服务（推荐实践）

要真正支持两种 scheme，需分别启动 HTTP 和 HTTPS 服务（常驻 goroutine）：

func main() {
    http.HandleFunc("/", handler)

    // 启动 HTTPS（需有效证书）
    go func() {
        log.Println("HTTPS server starting on :8443")
        log.Fatal(http.ListenAndServeTLS(":8443", "localhost.crt", "localhost.key", nil))
    }()

    // 启动 HTTP
    log.Println("HTTP server starting on :8080")
    log.Fatal(http.ListenAndServe(":8080", nil))
}

3. 处理反向代理场景（如 Nginx / Cloudflare）

当 Go 应用部署在反向代理之后时，客户端实际以 HTTPS 访问代理，但代理以 HTTP 转发给 Go 后端（即 r.TLS == nil），此时仅靠 r.TLS 会误判为 HTTP。

✅ 解决方案：检查代理注入的请求头（需代理配置转发）：

X-Forwarded-Proto: https
X-Forwarded-SSL: on
（或更通用的）X-Forwarded-For + 信任代理 IP 后校验头

示例（带基础校验）：

func getScheme(r *http.Request) string {
    // 优先信任 X-Forwarded-Proto（仅当来源可信时）
    if proto := r.Header.Get("X-Forwarded-Proto"); proto == "https" || proto == "http" {
        return proto
    }
    // 回退到 TLS 检测
    if r.TLS != nil {
        return "https"
    }
    return "http"
}

func handler(w http.ResponseWriter, r *http.Request) {
    scheme := getScheme(r)
    fmt.Fprintf(w, "Detected scheme: %s\n", scheme)
}

? 重要提醒：

X-Forwarded-* 头可被客户端伪造，切勿在未验证代理 IP 的情况下直接信任；应在中间件中校验 r.RemoteAddr 是否属于可信代理网段。
生产环境建议使用 gorilla/handlers.ProxyHeaders 等成熟中间件自动安全处理转发头。

总结

场景	推荐判断方式
独立运行 HTTP 或 HTTPS	直接硬编码 scheme（如 `":8080"` → `"http"`）
双协议直连服务	`r.TLS != nil` → `"https"`，否则 `"http"`
反向代理后端	结合 `X-Forwarded-Proto`（需可信代理校验）+ `r.TLS` 回退