Cookie 基本概念
Cookie 是伺服器發送至瀏覽器的小型文字資料,瀏覽器儲存並於後續請求自動攜帶。常用於會話追蹤、個人化偏好、記住登入等。
寫入 Cookie(伺服器 → 瀏覽器)
<%@ page contentType="text/html;charset=UTF-8" pageEncoding="UTF-8" %>
<%
// 1. 建立 Cookie:名稱、值
Cookie cookie = new Cookie("userName", "JohnDoe");
// 2. 設定屬性
cookie.setMaxAge(60 * 60 * 24 * 30); // 存活 30 天(秒),負數=會話級,0=刪除
cookie.setPath("/"); // 生效路徑,預設為當前請求路徑
cookie.setDomain(".example.com"); // 生效域名,支援子域名共享(可選)
cookie.setSecure(true); // 僅 HTTPS 傳輸(生產環境建議開啟)
cookie.setHttpOnly(true); // 禁止 JS 存取,防 XSS 竊取(需 Servlet 3.0+)
// cookie.setComment("用戶識別"); // 描述(舊版用)
// 3. 寫入回應
response.addCookie(cookie);
%>
<html><body>Cookie 已寫入</body></html>
讀取 Cookie(瀏覽器 → 伺服器)
<%@ page contentType="text/html;charset=UTF-8" pageEncoding="UTF-8" %>
<%
Cookie[] cookies = request.getCookies(); // 取得所有 Cookie 陣列
String userName = null;
if (cookies != null) {
for (Cookie c : cookies) {
if ("userName".equals(c.getName())) {
userName = c.getValue();
break;
}
}
}
%>
<html><body>
<h3>歡迎回來,<%= (userName != null ? userName : "訪客") %></h3>
<table border="1">
<tr><th>Cookie 名稱</th><th>Cookie 值</th></tr>
<%
if (cookies != null) {
for (Cookie c : cookies) {
%>
<tr><td><%= c.getName() %></td><td><%= c.getValue() %></td></tr>
<% } } %>
</table>
</body></html>
Cookie 核心屬性詳細說明
| 屬性 | 方法 | 說明 | 範例 |
| Name | 建構子 | 識別名稱,不可修改 | new Cookie("sid", "abc") |
| Value | 建構子 / setValue() | 儲存資料,**不可含分號、逗號、空白、等號**等特殊字元 | URLEncoder.encode("中文", "UTF-8") |
| MaxAge | setMaxAge(int 秒) | 存活秒數:>0 持久化、=0 刪除、<0 會話級(關閉瀏覽器失效) | 30天: 60*60*24*30 |
| Path | setPath(String) | URL 路徑前綴匹配,**預設為建立 Cookie 的請求路徑**,建議設 / | /app/, / |
| Domain | setDomain(String) | 域名匹配,.example.com 含子域名,**不可跨主域名設定** | .example.com |
| Secure | setSecure(boolean) | 僅 HTTPS 傳輸,防竊聽 | true (生產環境) |
| HttpOnly | setHttpOnly(boolean) | 禁止 JavaScript document.cookie 存取,防 XSS | true (敏感 Cookie) |
| SameSite | setAttribute("SameSite", "Strict/Lax/None") | 防 CSRF:Strict(同站)、Lax(部分鏈接)、None(跨站需 Secure) | Lax (預設) |
實用工具類
public class CookieUtil {
public static void addCookie(HttpServletResponse resp, String name, String value, int maxAge) {
Cookie c = new Cookie(name, value);
c.setMaxAge(maxAge);
c.setPath("/");
c.setHttpOnly(true);
c.setSecure(true); // 僅 HTTPS 環境
resp.addCookie(c);
}
public static String getCookie(HttpServletRequest req, String name) {
Cookie[] cookies = req.getCookies();
if (cookies != null) {
for (Cookie c : cookies) if (name.equals(c.getName())) return c.getValue();
}
return null;
}
public static void removeCookie(HttpServletResponse resp, String name) {
Cookie c = new Cookie(name, "");
c.setMaxAge(0);
c.setPath("/");
resp.addCookie(c);
}
}
關鍵注意事項
- 版本相容性:Java
javax.servlet.http.Cookie 僅支援 Version 0 (Netscape 規範)。Version 1 (RFC 2109) 新增 Comment、Port、CommentURL 等屬性,**Java 標準庫不支援**,需自行解析 Header。
- 值編碼限制:Cookie 值不可含
; , = 空白 " ' / ? @ : [ ]。中文/特殊字元**必須 URLEncoder.encode()**,讀取時 URLDecoder.decode()。
- 大小限制:單個 Cookie ≤ 4KB,單域名總數 ≤ 20-50 個(瀏覽器差異)。大數據請用 localStorage/Session/資料庫。
- 安全性:敏感資料(Session ID、Token)**必須**設定
HttpOnly=true, Secure=true, SameSite=Strict/Lax。
- 路徑陷阱:
setPath("/app") 僅在 /app/* 送出,/other 不送。統一用 / 避免遺漏。
現代替代方案
| 方案 | 容量 | 自動攜帶 | 適用場景 |
| Cookie | 4KB | 是 (HTTP Header) | Session ID、CSRF Token、追蹤 ID |
| localStorage | 5-10MB | 否 (JS 手動) | 用戶偏好、離線快取、大型客戶端狀態 |
| sessionStorage | 5-10MB | 否 | 單標籤頁臨時資料 |
| IndexedDB | 數百 MB | 否 | 結構化離線資料、PWA |
| JWT (Header/Body) | 無限制 | 由前端控制 | 無狀態認證、微服務授權 |