C# Cookie 完整操作指南：從結構解析到跨域容器實戰

Cookie 核心結構與屬性詳解

依據 Netscape 標準，HTTP Cookie 格式為：
Set-Cookie: NAME=VALUE; Expires=DATE; Path=PATH; Domain=DOMAIN_NAME; SECURE

三大集合類別關係圖

• HttpCookie：單一 Cookie 物件。
• HttpCookieCollection：單一域 下所有 Cookie 的集合 (Request.Cookies / Response.Cookies)。
• CookieContainer：多域 容器，支援自動管理過期清理、大小限制，適用於 HttpWebRequest 客戶端模擬登入場景。

轉換關鍵：CookieContainer.GetCookies(uri) → CookieCollection；CookieCollection[index] → Cookie。

實戰封裝類：設定、讀取、刪除、跨域

public static class CookieHelper
{
    /// 
寫入 Cookie (支援跨子域)
    public static bool Set(string name, string value, int expireDays, string domain = null)
    {
        try
        {
            var cookie = new HttpCookie(name, value)
            {
                Expires = DateTime.Now.AddDays(expireDays),
                HttpOnly = true, // 安全預設
                // Secure = true, // 僅 HTTPS 環境啟用
            };
            if (!string.IsNullOrEmpty(domain)) cookie.Domain = domain; // 如 ".example.com"
            HttpContext.Current.Response.Cookies.Add(cookie);
            return true;
        }
        catch { return false; }
    }

    /// 
讀取 Cookie 值
    public static string Get(string name)
    {
        var cookie = HttpContext.Current.Request.Cookies[name];
        return cookie?.Value; // 回傳 null 或值
    }

    /// 
刪除 Cookie (設定過期時間為過去)
    public static bool Remove(string name, string domain = null)
    {
        try
        {
            var cookie = new HttpCookie(name) { Expires = DateTime.Now.AddDays(-1) };
            if (!string.IsNullOrEmpty(domain)) cookie.Domain = domain;
            HttpContext.Current.Response.Cookies.Add(cookie);
            return true;
        }
        catch { return false; }
    }
}

CookieContainer 進階操作 (HttpClient / HttpWebRequest)

var container = new CookieContainer();

// 1. 從回應標頭手動解析並加入 (注意 Domain 格式陷阱)
string setCookieHeader = response.Headers.Get("Set-Cookie");
// ⚠️ SetCookies 的 uri 不能與 cookie Domain 完全相同 (如 .google.com)
// 解決：使用具體子域 uri，如 new Uri("https://www.google.com")
container.SetCookies(new Uri("https://www.google.com"), setCookieHeader);

// 2. 取得指定網站所有 Cookie 字串 (供後續請求帶入)
string cookieHeader = container.GetCookieHeader(new Uri("https://www.google.com"));

// 3. 手動新增單一 Cookie
container.Add(new Uri("https://api.example.com"), new Cookie("token", "abc123") { Domain = ".example.com" });

常見坑點提醒

1. Domain 格式：跨子域必須以點開頭 (.example.com)，且 SetCookies 的 URI 不能是裸域 (需 www.example.com)。
2. 編碼問題：值含中文/特殊字元請 HttpUtility.UrlEncode / UrlDecode。
3. SameSite 屬性：.NET Core 2.1+ 可設 cookie.SameSite = SameSiteMode.Lax 防禦 CSRF。
4. 大小限制：單一 Cookie ≤ 4KB，單一域 ≤ 20~50 個，超出會被瀏覽器忽略。