Cookie 的 path 與 domain 屬性決定了其「可見範圍」:哪些頁面能讀取、哪些域能共享。誤用會導致 Cookie 無法讀取、跨域共享失敗、安全風險。本文通過圖解與實例徹底講透兩大屬性。
指定 Cookie 關聯的 URL 路徑前綴。瀏覽器發送請求時,若請求路徑 以 Path 為前綴,則攜帶該 Cookie。
設置 Cookie 的頁面所在目錄(不含文件名)。如 https://example.com/dir/page.html 設置 Cookie,默認 Path = /dir/。
| Cookie Path | 可訪問的 URL 示例 | 不可訪問示例 |
|---|---|---|
| / | 全站所有頁面 | 無 |
| /app/ | /app/, /app/page, /app/sub/page | /other/, /app2/ |
| /app | /app, /app/, /apppage (前綴匹配!) | /application/ |
關鍵:Path 是前綴匹配,非目錄邊界。/app會匹配/appxxx。最佳實踐:總是以 / 結尾(目錄語義)或設為/。
指定 Cookie 關聯的域名。瀏覽器發送請求時,若請求域名 以 Domain 為尾綴(且非公共後綴),則攜帶該 Cookie。
設置 Cookie 的頁面的完整主機名(不含端口)。如 www.example.com 設置,默認 Domain = www.example.com(不帶點)。
sub.example.com 可設 .example.com,不可設 .other.com。.example.com 表示「example.com 及所有子域」。example.com 現代瀏覽器視同 .example.com,但舊版 IE 有差異,建議統一帶點。// 在 a.example.com 設置,供所有 *.example.com 讀取
document.cookie = "token=abc; domain=.example.com; path=/; Secure; SameSite=Lax";
// b.example.com、c.example.com 均可讀取 token
在 example.com 設置 domain=.example.com,sub.example.com 可讀。但 無法 在 sub.example.com 設置 Cookie 使 example.com 讀取(瀏覽器禁止設置非當前域尾綴的 Domain)。
| 設置頁面 | Cookie 設置 | 可讀取頁面範例 |
|---|---|---|
| www.example.com/app | Path=/app, Domain=.example.com | app.example.com/app/*, api.example.com/app/* |
| www.example.com | Path=/, Domain=.example.com | 所有子域所有路徑 |
| sub.example.com | Path=/, Domain=sub.example.com | 僅 sub.example.com 全路徑 |
Domain + Path 的 Cookie 存儲在同一文件/數據庫記錄中,以 * 分隔(瀏覽器內部實現)。單個 Cookie 值可編碼為 key1=val1&key2=val2,ASP.NET HttpCookie.Values 自動解析。缺點:單 Cookie 4KB 限制易觸頂,解析依賴特定框架,不推薦。現代方案:每個業務鍵用獨立 Cookie,或改用 localStorage / sessionStorage / JWT。
Secure:僅 HTTPS 傳輸。HttpOnly:禁止 JS 讀取(document.cookie 不可見),防 XSS 竊取。SameSite:Strict/Lax/None,防 CSRF。None 必須配合 Secure。// 登入 Token:全站、跨子域、僅 HTTPS、防 XSS、CSRF 保護
Set-Cookie: auth_token=xyz123; Domain=.example.com; Path=/; Secure; HttpOnly; SameSite=Lax; Max-Age=2592000
// 偏好設置:僅當前域、無 HttpOnly(需 JS 讀寫)、1 年
Set-Cookie: theme=dark; Domain=www.example.com; Path=/; Max-Age=31536000
精準配置 Path 与 Domain,是實現單點登入、多子域共享、權限隔離的基石。