JSONP 原理速覽
瀏覽器同源策略限制 Ajax 跨域,但 <script> 標籤不受限制。JSONP 利用此特性:
- 客戶端聲明全局回調函數
callbackName(data)
- 請求 URL 附帶
?callback=callbackName
- 服務端返回
callbackName({...json數據...})
- 瀏覽器執行腳本,觸發回調,獲得數據
jQuery JSONP 核心參數
| 參數 | 說明 |
| dataType: 'jsonp' | 啟用 JSONP 模式 |
| jsonp: 'callback' | URL 參數名(默認 callback) |
| jsonpCallback: 'fnName' | 指定回調函數名(可選,默認隨機) |
| cache: true | 允許緩存(默認 false 防緩存) |
完整客戶端代碼
// 方式 1:自動回調名(推薦)
$.ajax({
url: 'https://api.example.com/data',
dataType: 'jsonp',
data: {param1: 'value1'},
success: function(data) {
console.log('數據:', data);
},
error: function(jqXHR, textStatus, errorThrown) {
console.error('JSONP 失敗:', textStatus, errorThrown);
}
});
// 方式 2:固定回調名(需配合服務端)
$.ajax({
url: 'https://api.example.com/data',
dataType: 'jsonp',
jsonpCallback: 'myFixedCallback', // 全局函數名
success: function(data) { /* ... */ }
});
// 全局定義(需在 ajax 前聲明)
window.myFixedCallback = function(data) {
console.log('固定回調收到:', data);
};
服務端實現 (多語言示例)
Node.js (Express)
app.get('/data', (req, res) => {
const callback = req.query.callback || req.query.jsonpCallback;
const data = {code: 0, msg: 'ok', data: {id: 1, name: 'Test'}};
if (callback) {
// JSONP 響應
res.type('application/javascript');
res.send(`${callback}(${JSON.stringify(data)})`);
} else {
// 普通 JSON
res.json(data);
}
});
Java (Spring MVC)
@GetMapping("/data")
public void jsonp(HttpServletRequest req, HttpServletResponse resp)
throws IOException {
String callback = req.getParameter("callback");
String json = "{\"code\":0,\"data\":{\"id\":1}}";
resp.setContentType("application/javascript;charset=UTF-8");
if (callback != null) {
resp.getWriter().write(callback + "(" + json + ")");
} else {
resp.getWriter().write(json);
}
}
PHP
0, 'data' => ['id' => 1]];
$json = json_encode($data);
if ($callback) {
header('Content-Type: application/javascript; charset=utf-8');
echo $callback . '(' . $json . ')';
} else {
header('Content-Type: application/json; charset=utf-8');
echo $json;
}
?>
實戰案例:拉勾招聘數據展示
<div id="lagouData">加載中...</div>
<script>
function renderLagou(data) {
var html = '<ul>';
$.each(data, function(i, job) {
if (i >= 10) return false; // 只顯示前 10
var title = '【' + job.city + '】' + job.positionName + ' (' + job.salary + ') - ' + job.companyName;
if (title.length > 20) title = title.substring(0, 19) + '...';
html += '<li><a href="' + job.posiitonDetailUrl + '" target="_blank" title="' +
job.city + ' ' + job.positionName + '">' + title + '</a></li>';
});
html += '</ul><a href="https://www.lagou.com" target="_blank">更多職位</a>';
$('#lagouData').html(html);
}
// JSONP 請求
$.ajax({
url: 'https://www.lagou.com/join/listW3cplus',
data: {kd: '前端開發'},
dataType: 'jsonp',
jsonpCallback: 'renderLagou', // 指定回調
cache: true,
success: renderLagou // 兼容性寫法
});
</script>
JSONP vs CORS 對比
| 特性 | JSONP | CORS |
| HTTP 方法 | 僅 GET | 全部 (GET/POST/PUT/DELETE...) |
| 安全性 | 低 (腳本注入風險) | 高 (受同源策略保護) |
| 錯誤處理 | 困難 (無狀態碼) | 完整 (status, response) |
| 請求體 | 不支持 | 支持 |
| 瀏覽器支持 | 極廣 (IE6+) | IE10+ (IE8/9 需 XDomainRequest) |
安全建議
- ✅ 僅用於公開只讀數據(如公開 API、廣告流、招聘信息)
- ✅ 驗證回調函數名:服務端白名單校驗
callback 參數,防 XSS
- ✅ 設置 CSP:
script-src 'self' https://trusted-api.com
- ❌ 絕不用於敏感操作(登錄、支付、用戶私有數據)
- 🔄 新項目優先用 CORS,JSONP 作為舊瀏覽器降級方案