使用 Ajax 跨網域時,若需要帶 Cookie 或驗證資訊,預設情況下瀏覽器不會自動附上。此時即使伺服器已設定 CORS,請求仍可能拿不到 Cookie,造成狀態遺失。
假設客戶端網域是 a.example.com,服務端網域是 b.example.com。先在 b.example.com 設定 Cookie,再由 a.example.com 發出跨網域 Ajax 請求。若未特別設定,回傳結果中的 Cookie 欄位會是空的。
前端需要把 withCredentials 設為 true,表示這個請求允許附帶驗證資訊:
xhrFields: {
withCredentials: true
}
若使用原生 XMLHttpRequest,也可直接設定 xhr.withCredentials = true。
伺服器端必須回傳允許附帶驗證資訊的標頭:
header('Access-Control-Allow-Credentials: true');
同時,Access-Control-Allow-Origin 不能設為星號,必須明確指定允許的來源網域,否則瀏覽器仍會拒絕。
若客戶端開啟 withCredentials,但伺服器沒有回傳 Access-Control-Allow-Credentials: true,請求會失敗。反之,若伺服器允許驗證資訊,Origin 也不能使用萬用字元。正式環境建議只開放必要網域,並避免任意來源攜帶 Cookie。