萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

JavaScript 清除 Cookie 失效的根因與徹底解決方案

現象:明明設置了過期時間,Cookie 還在

// 設置 Cookie (帶 path=/)
document.cookie = 'sdmenu_state=open; expires=Fri, 31 Dec 2099 23:59:59 GMT; path=/';

// 嘗試刪除
document.cookie = 'sdmenu_state=; expires=Thu, 01 Jan 1970 00:00:00 GMT; path=/';
// 刷新頁面,Cookie 依然存在!

根本原因:Cookie 唯一標識 = name + domain + path

瀏覽器判斷兩個 Cookie 是否為「同一個」時,**同時比較 name、domain、path 三個屬性**。只有三者完全一致,後設置的才會覆蓋前者。

  • 設置時:path=/、domain=.example.com (或默認當前域)
  • 刪除時:必須完全一致 的 domain 和 path,否則會創建一個「同名但不同 path/domain」的新 Cookie,原 Cookie 仍生效

經典坑:domain 自動加點號

// 服務端設置 (PHP/Java)
setcookie('token', 'abc', 0, '/', 'example.com'); 
// 瀏覽器實際存儲 domain = '.example.com' (自動加前導點)

// 前端刪除
document.cookie = 'token=; expires=...; path=/; domain=example.com'; 
// 瀏覽器存儲 domain = 'example.com' (無點號) → 與原 '.example.com' 不匹配 → 刪除失效!

鐵律:設置時怎麼寫,刪除時就怎麼寫 (只改 value 和 expires)

// 獲取當前 Cookie 完整屬性 (需解析 document.cookie 字符串)
function getCookieOptions(name) {
  var cookies = document.cookie.split('; ');
  for (var i = 0; i < cookies.length; i++) {
    var parts = cookies[i].split('=');
    if (parts[0] === name) {
      // 只能獲取 name/value,無法獲取 domain/path/expires/HttpOnly/Secure
      // 瀏覽器安全策略:document.cookie 不暴露屬性元數據
      return null; 
    }
  }
  return null;
}

// 因此:前端刪除時,必須「知道」設置時的 domain/path
// 最佳實踐:前後端約定固定的 cookie 配置常量
var COOKIE_CONFIG = {
  path: '/',
  domain: location.hostname === 'localhost' ? '' : '.' + location.hostname.replace(/^[^.]+\./, ''), // 主域
  secure: location.protocol === 'https:',
  sameSite: 'Lax'
};

function setCookie(name, value, maxAgeSeconds) {
  var opts = [];
  opts.push(name + '=' + encodeURIComponent(value));
  if (maxAgeSeconds) opts.push('max-age=' + maxAgeSeconds);
  if (COOKIE_CONFIG.path) opts.push('path=' + COOKIE_CONFIG.path);
  if (COOKIE_CONFIG.domain) opts.push('domain=' + COOKIE_CONFIG.domain);
  if (COOKIE_CONFIG.secure) opts.push('secure');
  if (COOKIE_CONFIG.sameSite) opts.push('samesite=' + COOKIE_CONFIG.sameSite);
  document.cookie = opts.join('; ');
}

function removeCookie(name) {
  // 關鍵:完全復用設置時的 path/domain/secure/samesite
  var opts = [];
  opts.push(name + '=');
  opts.push('max-age=0'); // 比 expires 更簡單標準
  if (COOKIE_CONFIG.path) opts.push('path=' + COOKIE_CONFIG.path);
  if (COOKIE_CONFIG.domain) opts.push('domain=' + COOKIE_CONFIG.domain);
  if (COOKIE_CONFIG.secure) opts.push('secure');
  if (COOKIE_CONFIG.sameSite) opts.push('samesite=' + COOKIE_CONFIG.sameSite);
  document.cookie = opts.join('; ');
}

// 使用
setCookie('token', 'abc123', 3600);
removeCookie('token'); // 保證匹配

通用刪除工具函數 (不依賴配置常量,解析現有 Cookie 推斷 path/domain)

注意:前端無法讀取現有 Cookie 的 domain/path/HttpOnly,只能「猜」。以下為常見啟發式方案:

function removeCookieHeuristic(name) {
  var hostname = location.hostname;
  var paths = ['/', '/app', '/admin', '/api']; // 常見 path 列表
  var domains = ['', '.' + hostname]; // 無 domain (當前主機) 和 主域
  
  // 如果是子域名,嘗試上一級域
  var parts = hostname.split('.');
  if (parts.length > 2) {
    domains.push('.' + parts.slice(1).join('.')); // .example.com
  }

  // 窮舉組合嘗試刪除
  domains.forEach(function (domain) {
    paths.forEach(function (path) {
      var cookieStr = name + '=; max-age=0; path=' + path;
      if (domain) cookieStr += '; domain=' + domain;
      if (location.protocol === 'https:') cookieStr += '; secure';
      cookieStr += '; samesite=Lax';
      document.cookie = cookieStr;
    });
  });
}

現代最佳實踐:封裝 CookieStore 類

class CookieStore {
  constructor(defaultOptions = {}) {
    this.defaults = {
      path: '/',
      domain: '',
      secure: location.protocol === 'https:',
      sameSite: 'Lax',
      ...defaultOptions
    };
  }

  _buildString(name, value, options) {
    var opts = { ...this.defaults, ...options };
    var parts = [name + '=' + encodeURIComponent(value)];
    if (opts.maxAge != null) parts.push('max-age=' + opts.maxAge);
    if (opts.expires) parts.push('expires=' + opts.expires.toUTCString());
    if (opts.path) parts.push('path=' + opts.path);
    if (opts.domain) parts.push('domain=' + opts.domain);
    if (opts.secure) parts.push('secure');
    if (opts.sameSite) parts.push('samesite=' + opts.sameSite);
    return parts.join('; ');
  }

  set(name, value, options) {
    document.cookie = this._buildString(name, value, options);
  }

  get(name) {
    var cookies = document.cookie.split('; ');
    for (var i = 0; i < cookies.length; i++) {
      var [k, v] = cookies[i].split('=');
      if (k === name) return decodeURIComponent(v);
    }
    return null;
  }

  remove(name, options) {
    // 必須傳入與設置時相同的 path/domain
    document.cookie = this._buildString(name, '', { 
      maxAge: 0, 
      ...options, 
      ...this.defaults 
    });
  }

  has(name) {
    return this.get(name) !== null;
  }
}

// 單例
var cookies = new CookieStore({ path: '/', domain: '.example.com' });
cookies.set('token', 'abc');
cookies.remove('token'); // 完美匹配

特殊情況處理

場景處理
HttpOnly Cookie前端無法讀寫/刪除,需後端接口配合刪除
Secure Cookie (HTTPS only)刪除時必須帶 secure,且頁面必須是 HTTPS
SameSite=Strict刪除時必須帶 samesite=Strict
跨域 iframe 設置的 Cookie受第三方 Cookie 政策限制,現代瀏覽器默認阻塞,需后端配合 Partitioned (CHIPS)
子域共享 Cookie設置 domain=.example.com,刪除時同樣指定

調試技巧

  1. 開發者工具 → Application/Storage → Cookies:查看實際存儲的 domain、path、expires、size
  2. Console 輸入 document.cookie 查看可見字符串
  3. Network 面板查看 Set-Cookie 響應頭與 Cookie 請求頭
  4. 使用 document.cookie = 'test=1; path=/; domain=.'+location.hostname 測試域匹配

總結

Cookie 刪除失效 99% 是 **path/domain 不匹配**。核心原則:**設置時什麼屬性,刪除時原樣保留,只改 value=空、max-age=0**。工程化做法是封裝 CookieStore 統一管理配置,前後端約定 domain/path 規範,杜絕手動拼接字符串導致的不一致。

copyright © 萬盛學電腦網 all rights reserved