萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

jQuery 跨域請求實戰:JSONP 原理與 $.getJSON 最佳實踐

瀏覽器同源策略限制 AJAX 跨域請求,JSONP(JSON with Padding)利用 <script> 標籤無跨域限制的特性,成為傳統跨域方案。本文解析原理、展示 $.getJSON 實戰用法,並給出後端配合規範。

一、JSONP 核心原理

  1. 客戶端聲明全局回調函數 callbackName(data)
  2. 動態創建 <script src="https://api.domain.com/data?callback=callbackName">
  3. 服務端返回 callbackName({...json數據...}) —— 可執行的 JS 代碼
  4. 瀏覽器執行腳本,觸發回調,獲得數據

二、$.getJSON 實現跨域 GET 請求

1. 客戶端代碼

$.getJSON("https://api.example.com/data.php?name=value&callback=?", function(response) {
    // response 為解析後的 JSON 對象
    console.log(response.name, response.age);
});

關鍵點:

  • URL 末尾 callback=?,jQuery 自動生成唯一回調函數名(如 jQuery123456789)並替換 ?
  • 僅支持 GET 請求
  • 返回內容必須是 合法 JavaScript 函數調用,非純 JSON

2. 完整示例:預約登記接口

// 前端頁面
$(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 示例)

<?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 進階配置(更可控)

$.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);
    }
});

五、JSONP 局限與安全風險

限制 說明
僅支持 GET <script> 只能發 GET 請求,無法發 POST/PUT/DELETE
無錯誤狀態碼 HTTP 4xx/5xx 不會觸發 error 回調,只能靠業務 code 判斷
腳本注入風險 第三方 API 若被劫持,可執行任意 JS 代碼(XSS)
阻塞頁面渲染 腳本加載執行會阻塞,大量並發影響性能
難以調試 Network 面板顯示為 script 類型,不易檢查請求/響應詳情

六、現代替代方案:CORS(推薦)

現代瀏覽器全面支持 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)。

七、遷移建議

  • 新項目直接用 CORS,拒絕 JSONP
  • 老項目逐步遷移:後端同時支持 JSONP 與 CORS,前端按域名切換
  • 必須用 JSONP 時:只調用可信域名、驗證響應格式、設置嚴格 CSP 策略

結語

JSONP 是時代產物,解決了早期跨域剛需。理解其「腳本注入 + 回調」本質,有助於排查疑難雜癥。現代開發請擁抱 CORS,享受標準、安全、完整的跨域體驗。

copyright © 萬盛學電腦網 all rights reserved