net/http/cookiejar未存储Cookie Expires/Max-Age问题求助

你的问题核心是标准库net/http的Cookie解析器无法正确处理API返回的Set-Cookie头格式，导致内存中Cookie的Expires、Max-Age和Path字段异常，但第三方持久化库做了兼容处理，所以磁盘文件里的字段是正确的。

排查关键点 #

1. 检查API返回的Set-Cookie头格式
   标准HTTP规范要求Expires字段必须使用RFC 1123格式（比如Wed, 11 Oct 2024 15:53:14 GMT），如果API返回的是ISO 8601格式（比如2024-10-11T15:53:14Z），net/http的解析器会直接解析失败，将Expires设为零值（0001-01-01），同时Max-Age也会被默认设为0。

   你可以在请求后打印响应的Set-Cookie头确认：

   resp, err := c.Http.Do(req)
   if err != nil {
       // 错误处理
   }
   defer resp.Body.Close()
   
   fmt.Println("Set-Cookie 响应头:", resp.Header["Set-Cookie"])
   

2. 循环变量重名的隐藏问题
   你的测试代码里循环变量用了c，和外层的Client实例变量重名，这会导致循环内部c被覆盖为*http.Cookie类型，后续调用c.Http.Jar会触发编译错误。虽然你的输出能运行，大概率是代码贴写时的笔误，但这个问题会导致逻辑混乱，建议立刻修正循环变量名（比如改为cookie）：

   for _, cookie := range c.Http.Jar.Cookies(u) {
       fmt.Println(cookie, cookie.Expires, cookie.Path)
   }
   

解决方案 #

方案1：修正API的Set-Cookie格式

让API端将Expires字段改为RFC 1123格式，这是最规范的解决方式，符合HTTP标准。

方案2：客户端自定义Cookie解析逻辑

如果无法修改API，可以自定义RoundTripper拦截响应，手动解析Set-Cookie头并添加到CookieJar中，兼容非标准的日期格式：

import (
    "net/http"
    "net/url"
    "strings"
    "time"
    "strconv"
)

type CustomCookieTransport struct {
    Base http.RoundTripper
    Jar  http.CookieJar
}

func (t *CustomCookieTransport) RoundTrip(req *http.Request) (*http.Response, error) {
    resp, err := t.Base.RoundTrip(req)
    if err != nil {
        return resp, err
    }

    // 手动解析所有Set-Cookie头
    for _, scStr := range resp.Header["Set-Cookie"] {
        cookie := t.parseSetCookie(scStr, req.URL)
        if cookie != nil {
            t.Jar.SetCookies(req.URL, []*http.Cookie{cookie})
        }
    }

    return resp, nil
}

func (t *CustomCookieTransport) parseSetCookie(scStr string, u *url.URL) *http.Cookie {
    parts := strings.Split(scStr, ";")
    if len(parts) == 0 {
        return nil
    }

    // 解析Name=Value
    nameValue := strings.SplitN(strings.TrimSpace(parts[0]), "=", 2)
    if len(nameValue) != 2 {
        return nil
    }

    cookie := &http.Cookie{
        Name:  nameValue[0],
        Value: nameValue[1],
        Path:  u.Path, // 默认使用请求路径
        Domain: u.Host,
    }
    if cookie.Path == "" {
        cookie.Path = "/"
    }

    // 解析其他参数
    for _, part := range parts[1:] {
        part = strings.TrimSpace(part)
        switch {
        case part == "HttpOnly":
            cookie.HttpOnly = true
        case part == "Secure":
            cookie.Secure = true
        case strings.HasPrefix(part, "Path="):
            cookie.Path = strings.TrimPrefix(part, "Path=")
        case strings.HasPrefix(part, "Domain="):
            cookie.Domain = strings.TrimPrefix(part, "Domain=")
        case strings.HasPrefix(part, "Max-Age="):
            maStr := strings.TrimPrefix(part, "Max-Age=")
            ma, _ := strconv.Atoi(maStr)
            cookie.MaxAge = ma
        case strings.HasPrefix(part, "Expires="):
            expStr := strings.TrimPrefix(part, "Expires=")
            // 兼容RFC 1123和ISO 8601格式
            expTime, err := time.Parse(time.RFC1123, expStr)
            if err != nil {
                expTime, _ = time.Parse(time.RFC3339, expStr)
            }
            cookie.Expires = expTime
        }
    }

    return cookie
}

然后将这个自定义Transport设置到你的http.Client中：

c.Http.Transport = &CustomCookieTransport{
    Base: http.DefaultTransport,
    Jar:  c.Http.Jar,
}

额外验证 #

如果上述方案解决了问题，说明确实是格式兼容问题。另外，你可以测试用标准RFC 1123格式的Set-Cookie头，确认标准库能正常解析所有字段。

内容的提问来源于stack exchange，提问作者Gonçalo