跨域是每個前端工程師都會撞上的牆。它並不是 bug,而是瀏覽器刻意設計的安全機制。把成因與解法一次搞懂,之後遇到就只是查表而已。
根因是瀏覽器的「同源策略(Same-Origin Policy)」:預設情況下,某個來源頁面裡的 JavaScript 只能讀取「同一來源」視窗的屬性與資料。這個限制擋住了惡意網站偷偷讀取你已登入網站內容的可能。
一個 URL 可以拆成四個部分:協定(protocol)、主機(host,含子網域)、連接埠(port)、路徑(path)。同源策略只看前三項,四者必須完全一致才算同源,路徑不同不影響。
舉例來說,https://github.com/ 的協定是 https、主機是 github.com、連接埠是 443(https 預設值)。只要協定、主機、連接埠其中任何一項不同,就算是跨域。因此從 https://localhost:80/ 去請求 https://127.0.0.1:80/ 一樣會被判定跨域——主機名稱不同就是不同來源。
最常見的是頁面用 AJAX 去呼叫別人的資料接口,例如天氣、物流、匯率;再來是 Hybrid App 的 WebView 頁面請求後端;以及本機開發時前端跑 3000 port、後端跑 8080 port。這時瀏覽器通常會丟出類似下面的錯誤:
XMLHttpRequest cannot load https://your-api-domain.com/xxx. No 'Access-Control-Allow-Origin' header is present on the requested resource. Origin 'https://your-page-domain.com' is therefore not allowed access.
1. JSONP:利用 script 標籤不受同源限制的特性,只支援 GET。
2. 後端代理:由自己的伺服器去請求目標接口,前端只打自己的同域端點。
3. CORS:由後端在回應標頭加上 Access-Control-Allow-Origin,這是目前最標準的做法。
JSONP 不等於 JSON,它其實是一段被刻意包裝過的 JavaScript 呼叫語句。原理是:瀏覽器允許 <script src> 載入任何來源的檔案,所以我們動態插入一個 script 標籤去請求後端,並附上一個 callback 參數告訴後端「要呼叫哪個函式」;後端把資料當成參數包進那個函式呼叫裡回傳,資料就到手了。
前端(以 jQuery 為例):
$.ajax({
url: "",
dataType: "jsonp",
data: {
params: ""
}
}).done(function (data) {
// 在這裡處理回傳的資料
});
後端回應的內容必須是「一段可執行的 JS」,而不是純 JSON 字串,否則瀏覽器會直接報語法錯誤。實際回應長得像這樣:
/**/ typeof jQuery21307270454438403249_1428044213638 === 'function' &&
jQuery21307270454438403249_1428044213638({"code":1,"msg":"success","data":{"test":"test"}});
前導的 /**/ 與 typeof 檢查不是裝飾:前者是為了緩解 Rosetta Flash 這類針對 JSONP 的回饋式攻擊,後者則是避免使用者端噴一堆錯誤訊息。Express 4.x 的 res.jsonp 就是這樣做的:
// jsonp
if (typeof callback === 'string' && callback.length !== 0) {
this.charset = 'utf-8';
this.set('X-Content-Type-Options', 'nosniff');
this.set('Content-Type', 'text/javascript');
// 限制 callback 只能包含合法的字元,避免注入
callback = callback.replace(/[^\[\]\w$.]/g, '');
// 這兩個字元在 JSON 中合法,但在 JS 中是換行符,必須轉義
body = body
.replace(/\u2028/g, '\\u2028')
.replace(/\u2029/g, '\\u2029');
// /**/ 是針對 Rosetta Flash JSONP 濫用的緩解手法
// typeof 檢查則是為了減少客戶端的錯誤雜訊
body = '/**/ typeof ' + callback + ' === \'function\' && ' + callback + '(' + body + ');';
}
只要後端在回應標頭加上 Access-Control-Allow-Origin 並指定允許的來源,瀏覽器就會放行,前端不需要再繞 JSONP。實務上不建議直接寫成萬用字元 *:搭配 cookie 的請求必須明確列出來源,且 Access-Control-Allow-Credentials: true 與萬用字元不能同時使用。另外「設成 * 是否會有安全風險」一直是社群討論的話題,結論通常是:公開讀取的資料用 * 沒問題,涉及身分或敏感資料的接口一定要白名單。
CORS 是 HTML5 時期制定的標準,IE10 以下完全不支援,因此在需要兼顧老舊 PC 環境的專案裡,仍得保留 JSONP 或後端代理作為退路。現代專案若已無需支援 IE,直接走 CORS 就是最乾淨的選擇。