瀏覽器同源策略限制 AJAX 跨域請求,JSONP(JSON with Padding)利用 <script> 標籤無跨域限制的特性,成為傳統跨域方案。本文解析原理、展示 $.getJSON 實戰用法,並給出後端配合規範。
callbackName(data)<script src="https://api.domain.com/data?callback=callbackName">callbackName({...json數據...}) —— 可執行的 JS 代碼$.getJSON("https://api.example.com/data.php?name=value&callback=?", function(response) {
// response 為解析後的 JSON 對象
console.log(response.name, response.age);
});
關鍵點:
callback=?,jQuery 自動生成唯一回調函數名(如 jQuery123456789)並替換 ?// 前端頁面
$(document).ready(function() {
var name = "張三", phone = "13800000000", addr = "北京市";
$.getJSON(
"https://api.example.com/data.php?ac=yuyue_interface" +
"&name=" + encodeURIComponent(name) +
"&phone=" + phone +
"&addr=" + encodeURIComponent(addr) +
"&callback=?",
function(data) {
switch (data.code) {
case 1: alert("姓名不能為空"); break;
case 2: alert("手機不能為空"); break;
case 3: alert("所在單位不能為空"); break;
case 0: alert("預約成功"); break;
default: alert("未知錯誤");
}
}
);
});
<?php
// data.php
$ac = $_GET['ac'];
if ($ac === 'yuyue_interface') {
$name = trim($_GET['name']);
$phone = trim($_GET['phone']);
$addr = trim($_GET['addr']);
$cb = $_GET['callback']; // 必須獲取並原樣輸出
$result = ['code' => 0];
if ($name === '') $result = ['code' => 1];
else if ($phone === '') $result = ['code' => 2];
else if ($addr === '') $result = ['code' => 3];
else {
// DB 操作...
// $db->execute("INSERT INTO ...");
}
// 關鍵:輸出 callback(json) 格式
header('Content-Type: application/javascript; charset=utf-8');
echo $cb . '(' . json_encode($result) . ')';
exit;
}
?>
$.ajax({
url: "https://api.example.com/data.php",
type: "GET",
dataType: "jsonp", // 指定 JSONP
jsonp: "callback", // 覆蓋默認 callback 參數名
jsonpCallback: "myCallback", // 指定回調函數名(可選,默認隨機)
data: {
ac: "yuyue_interface",
name: "張三",
phone: "13800000000",
addr: "北京市"
},
timeout: 5000,
success: function(json) { /* 同 getJSON */ },
error: function(xhr, textStatus) {
// JSONP 錯誤捕獲有限:腳本加載失敗才觸發
console.log("請求失敗:", textStatus);
}
});
| 限制 | 說明 |
|---|---|
| 僅支持 GET | <script> 只能發 GET 請求,無法發 POST/PUT/DELETE |
| 無錯誤狀態碼 | HTTP 4xx/5xx 不會觸發 error 回調,只能靠業務 code 判斷 |
| 腳本注入風險 | 第三方 API 若被劫持,可執行任意 JS 代碼(XSS) |
| 阻塞頁面渲染 | 腳本加載執行會阻塞,大量並發影響性能 |
| 難以調試 | Network 面板顯示為 script 類型,不易檢查請求/響應詳情 |
現代瀏覽器全面支持 CORS(跨域資源共享),只需服務端添加響應頭:
// 服務端(Node/Express 示例)
app.use((req, res, next) => {
res.header('Access-Control-Allow-Origin', '*'); // 或指定域名
res.header('Access-Control-Allow-Methods', 'GET,POST,PUT,DELETE,OPTIONS');
res.header('Access-Control-Allow-Headers', 'Content-Type, Authorization');
if (req.method === 'OPTIONS') return res.sendStatus(200);
next();
});
前端無需改動,直接用 $.ajax / fetch 發送跨域請求,支持所有 HTTP 方法、完整錯誤處理、攜帶 Cookie(需 credentials: true)。
JSONP 是時代產物,解決了早期跨域剛需。理解其「腳本注入 + 回調」本質,有助於排查疑難雜癥。現代開發請擁抱 CORS,享受標準、安全、完整的跨域體驗。