Go语言net/http包中服务器端Cookie的正确设置方法

func SetCookie(w ResponseWriter, cookie *Cookie)

type Cookie struct {
    Name       string    // Cookie的名称
    Value      string    // Cookie的值
    Path       string    // Cookie的有效路径，默认为"/"
    Domain     string    // Cookie的有效域名，默认为当前域名
    Expires    time.Time // Cookie的过期时间，如果设置，则为持久性Cookie
    RawExpires string    // 用于直接设置Expires头字段的字符串
    MaxAge     int       // Cookie的最大存活时间（秒），与Expires二选一
    Secure     bool      // 是否只通过HTTPS发送Cookie
    HttpOnly   bool      // 是否禁止客户端脚本访问Cookie
    SameSite   SameSite  // SameSite策略，防止CSRF攻击
    Raw        string    // 原始的Set-Cookie头字段
    Unparsed   []string  // 原始Set-Cookie头字段中未解析的部分
}

package main

import (
    "fmt"
    "io"
    "net/http"
    "time"
)

// indexHandler 处理根路径的请求
func indexHandler(w http.ResponseWriter, req *http.Request) {
    // 1. 创建一个http.Cookie实例
    // 设置Cookie的名称、值、过期时间、路径、域名、HttpOnly和Secure属性
    cookie := &http.Cookie{
        Name:     "user_session",             // Cookie的名称
        Value:    "session_token_12345",      // Cookie的值
        Path:     "/",                        // Cookie在所有路径下都有效
        Domain:   "",                         // 留空表示当前请求的域名
        Expires:  time.Now().Add(24 * time.Hour), // Cookie在24小时后过期
        HttpOnly: true,                       // 阻止客户端脚本访问Cookie，增强安全性
        Secure:   false,                      // 仅通过HTTPS发送，在开发环境可设为false，生产环境应为true
        SameSite: http.SameSiteLaxMode,       // 推荐的SameSite策略，防止CSRF
    }

    // 2. 使用http.SetCookie将Cookie添加到响应中
    http.SetCookie(w, cookie)

    // 也可以设置一个MaxAge的Cookie（会话Cookie或带过期时间的持久Cookie）
    // maxAgeCookie := &http.Cookie{
    //  Name:     "user_preference",
    //  Value:    "theme=dark",
    //  Path:     "/",
    //  MaxAge:   3600, // 1小时后过期
    //  HttpOnly: false, // 允许客户端脚本访问
    //  Secure:   false,
    // }
    // http.SetCookie(w, maxAgeCookie)

    // 3. 向客户端发送响应内容
    io.WriteString(w, "Hello world! Cookie 'user_session' has been set.")
    fmt.Println("Cookie 'user_session' set for client.")
}

func main() {
    // 注册请求处理器
    http.HandleFunc("/", indexHandler)

    // 启动HTTP服务器，监听8080端口
    fmt.Println("Server listening on :8080")
    err := http.ListenAndServe(":8080", nil)
    if err != nil {
        fmt.Printf("Server failed to start: %v\n", err)
    }
}