HTTP ETag与重定向：Go语言客户端的实践与注意事项

本文深入探讨HTTP ETag在重定向场景下的行为及Go语言客户端的实现策略。我们将解析ETag与重定向URL的关联，以及服务器在处理条件请求时，重定向状态码如何优先于ETag等前置条件。通过Go语言示例代码，分析客户端如何正确管理ETag，并强调在面对重定向时，应将ETag与最终资源URL关联，同时警惕重定向响应中ETag的有效性。

理解HTTP ETag与条件请求

HTTP ETag（实体标签）是HTTP协议中用于缓存验证的一种机制，它允许客户端和服务器有效地判断资源是否已更改。当客户端发起请求时，如果它之前接收过该资源的ETag，可以通过 If-None-Match 请求头将其发送给服务器。服务器收到后，会比较请求中的ETag与当前资源的ETag。如果匹配，服务器通常会返回 304 Not Modified 状态码，指示客户端使用其缓存副本，从而节省带宽和服务器资源。如果不匹配，服务器则返回 200 OK 状态码和更新后的资源内容，并附带新的ETag。

Go语言客户端的ETag管理实现

为了演示ETag在客户端的实际应用，我们构建一个自定义的Go语言HTTP客户端，它能够自动存储和发送ETag。以下是该客户端的核心实现：

package util

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

// HttpClient 扩展了标准的 http.Client，增加了 ETag 管理功能
type HttpClient struct {
    http.Client
    etags map[url.URL]string // 存储 URL 到 ETag 的映射
}

// Do 方法拦截请求，实现 ETag 的发送和存储逻辑
func (hc *HttpClient) Do(req *http.Request) (*http.Response, error) {
    const ETAG_SERVER_HEADER = "ETag"
    const ETAG_CLIENT_HEADER = "If-None-Match"

    // 仅对 GET 请求处理 ETag
    if req.Method != "GET" {
        return hc.Client.Do(req)
    }

    // 检查是否存在当前 URL 的 ETag
    // 注意：这里使用 *req.URL 作为 key，这在重定向场景下需要特别注意
    etag, ok := hc.etags[*req.URL]
    if ok {
        // 如果存在 ETag，将其添加到 If-None-Match 请求头
        if req.Header == nil {
            req.Header = http.Header{}
        }
        req.Header.Add(ETAG_CLIENT_HEADER, etag)
    }

    // 执行实际的 HTTP 请求
    response, err := hc.Client.Do(req)

    // 如果请求成功且没有错误
    if err == nil {
        if hc.etags == nil {
            hc.etags = make(map[url.URL]string)
        }

        // 从响应头中获取 ETag，如果存在则存储
        // 关键点：这里应该使用 response.Request.URL 来存储 ETag，
        // 因为它代表了经过重定向后的最终资源URL。
        serverEtag := response.Header.Get(ETAG_SERVER_HEADER)
        if len(serverEtag) != 0 {
            // 修正：将 ETag 关联到最终请求的 URL
            hc.etags[*response.Request.URL] = serverEtag
        }
    }

    return response, err
}

登录后复制

代码解析与改进点：

立即学习“go语言免费学习笔记（深入）”；

上述代码通过在 Do 方法中拦截请求，实现了ETag的自动管理。当发起 GET 请求时，客户端会检查本地缓存中是否存在该URL对应的ETag。如果存在，则将其添加到 If-None-Match 请求头中。请求完成后，如果响应成功，客户端会从响应头中提取 ETag，并将其存储起来以备后续使用。

重要改进点： 在原始代码中，ETag的存储使用了 *req.URL 作为 map 的键。然而，Go的 http.Client 默认会跟随重定向。这意味着，如果一个请求 http://foo.com/bar.html 最终被重定向到 http://foo.com/qux.html 并返回 200 OK 及 ETag，那么这个ETag实际上是属于 qux.html 的。因此，正确的做法是使用 response.Request.URL 作为存储ETag的键，因为 response.Request.URL 包含了所有重定向之后最终请求的URL。上述代码已对这部分进行了修正。

标签： html go go语言 状态码