瀏覽器同源策略限制了不同源(協議、域名、埠口任一不同)之間的腳本交互。本文系統梳理 5 種主流跨域方案,重點剖析 JSONP 原理與實現,並推薦現代項目採用 CORS 或 Node 代理作為標準解法。
| 方案 | 原理 | 優點 | 缺點 | 適用場景 |
|---|---|---|---|---|
| JSONP | 動態建立 <script> 標籤,利用 src 跨域特性,伺服器回呼指定函數 | 相容極佳(IE6+)、無需伺服器配合 CORS | 僅支援 GET、易受 XSS 攻擊、錯誤處理困難 | 舊專案、第三方無 CORS 的公開 API |
| 表單 POST + iframe | <form target="hiddenIframe"> 提交,iframe 接收回應 | 可跨域 POST、無需 JS 配合 | 體驗差、無法獲取詳細回應狀態、已淘汰 | 極舊環境下的檔案上傳 |
| 伺服器代理 | 自家後端轉發請求至目標 API,再回傳給前端 | 完全可控、可隱藏金鑰、支援所有方法 | 增加後端負擔、延遲略高 | 企業級應用、需認證的私有 API |
| HTML5 XDomainRequest / CORS | 伺服器設定 Access-Control-Allow-Origin 標頭,瀏覽器自動放行 | 標準化、支援所有 HTTP 方法、安全機制完善 | IE8/9 需用 XDomainRequest、老瀏覽器不支援 | 現代 Web 標準首選 |
| Flash / Silverlight | 利用插件跨域能力,JS 呼叫插件橋接 | 曾經萬能 | 插件已死、安全隱患大、移動端不支援 | 已棄用 |
callbackName(data)。<script src="https://api.example.com/data?callback=callbackName">。callbackName({"key": "value"})(JavaScript 代碼)。階段 1:靜態腳本跨域
<!-- 本地頁面 -->
<script src="https://remoteserver.com/remote.js"></script>
// remote.js 內容:alert('我是遠端檔案');
階段 2:前端定義函數,遠端呼叫
<script>
var localHandler = function(data) {
alert('收到遠端資料:' + data.result);
};
</script>
<script src="https://remoteserver.com/remote.js"></script>
// remote.js 內容:localHandler({"result": "遠端資料"});
階段 3:動態傳遞回呼名稱(標準 JSONP)
<script>
var flightHandler = function(data) {
alert('航班 ' + data.code + ':' + data.price + ' 元,餘票 ' + data.tickets + ' 張');
};
var url = "https://flightQuery.com/jsonp/flightResult.aspx?code=CA1998&callback=flightHandler";
var script = document.createElement('script');
script.src = url;
document.getElementsByTagName('head')[0].appendChild(script);
</script>
// 伺服器回應:flightHandler({"code":"CA1998","price":1780,"tickets":5});
$.ajax({
url: 'https://api.example.com/data',
dataType: 'jsonp', // 關鍵:啟用 JSONP 模式
jsonp: 'callback', // 參數名,預設 callback
jsonpCallback: 'myCb', // 可選:指定回呼函數名
success: function(response) {
console.log('JSONP 成功:', response);
},
error: function(xhr, status, err) {
console.error('JSONP 失敗:', status, err);
}
});
CORS(跨域資源共享) 是 W3C 標準,只需後端在回應中加入標頭:
// Node.js Express 範例
app.use((req, res, next) => {
res.header('Access-Control-Allow-Origin', 'https://your-frontend.com'); // 或 *(不帶憑證時)
res.header('Access-Control-Allow-Methods', 'GET,POST,PUT,DELETE,OPTIONS');
res.header('Access-Control-Allow-Headers', 'Content-Type,Authorization');
res.header('Access-Control-Allow-Credentials', 'true'); // 若需攜帶 Cookie
if (req.method === 'OPTIONS') return res.sendStatus(200); // 預檢請求快速回應
next();
});
若無法控制目標伺服器(如第三方 API),在自家 Node/Java/Go 層建立 BFF(Backend for Frontend)代理:
// 簡易 Node 代理
app.get('/api/proxy', async (req, res) => {
try {
const response = await fetch('https://third-party.com/data', {
headers: { 'Authorization': 'Bearer SECRET_KEY' } // 隱藏金鑰
});
const data = await response.json();
res.json(data);
} catch (e) {
res.status(502).json({ error: 'Upstream failed' });
}
});