在前后端分离还不流行的年代，jQuery几乎是每个前端项目的标配，而$.getJSON()则是当时最常用的数据请求方法之一。它的作用很明确：向服务器发起一个GET请求，要求服务器返回JSON格式的数据，并且自动把返回的JSON字符串解析成JavaScript对象，省去了手动调用JSON.parse()的步骤。虽然现在axios和fetch逐渐成为主流，但大量老项目仍在使用jQuery，理解getJSON的原理和使用细节依然很有必要。
getJSON方法的基本语法与参数详解
先看最基础的调用形式。$.getJSON()的完整签名是jQuery.getJSON(url, data, success)，其中url是必填参数，data和success都可以省略。下面是一个典型的例子：
$.getJSON("https://api.ipipp.com/api/users", { page: 1, size: 10 }, function(data) {
console.log(data); // data已经是解析好的JavaScript对象
});这段代码会向接口地址发送一个GET请求，查询参数会被自动拼接到URL后面，实际请求的地址变成https://api.ipipp.com/api/users?page=1&size=10。回调函数在请求成功且数据解析无误后执行，拿到的data参数就是解析完成的JSON对象。如果不需要传参数，可以直接写成两个参数的形式：
$.getJSON("https://api.ipipp.com/api/config", function(data) {
if (data.code === 0) {
console.log("配置加载成功", data.result);
}
});有一点值得注意，getJSON内部本质上调用的是$.ajax()，它相当于预设了type: "GET"和dataType: "json"两个配置项。这意味着服务器响应的Content-Type最好设置为application/json，jQuery会根据这个类型来判断如何解析数据。即使响应头不标准，jQuery也会尝试把返回内容当作JSON来解析，一旦解析失败，回调函数就不会执行，这是后面要讲的误区之一。
getJSON与ajax方法的对比及链式写法
既然getJSON是ajax的封装，那什么时候该用哪个？如果只是简单地拉取JSON数据，getJSON写起来更短、意图更清晰；如果需要处理错误、设置请求头、支持POST等复杂场景，就应该直接使用$.ajax()。下面两种写法是等价的：
// 方式一：使用getJSON
$.getJSON("/api/article/1", function(data) {
console.log(data.title);
});
// 方式二：使用ajax，效果完全相同
$.ajax({
url: "/api/article/1",
type: "GET",
dataType: "json",
success: function(data) {
console.log(data.title);
}
});getJSON从jQuery 1.5开始支持Deferred链式写法，可以用.done()、.fail()、.always()来注册回调，比传统的回调函数参数更灵活：
$.getJSON("/api/weather?city=beijing")
.done(function(data) {
console.log("温度：", data.temp);
})
.fail(function(jqXHR, textStatus, error) {
console.log("请求失败：", textStatus, error);
})
.always(function() {
console.log("请求结束，无论成败都执行");
});链式写法最大的好处是可以注册多个done回调，并且能通过$.when()合并多个请求，等所有请求都完成后再统一处理，这在需要并行加载多份数据的场景下非常实用。
回调不执行？这几个常见误区逐一排查
误区一：以为getJSON有error回调参数。不少人写出$.getJSON(url, function(data){...}, function(err){...})这样的代码，然后发现请求失败时第三个函数根本不会执行。原因很简单，getJSON的参数列表里没有error回调，失败处理只能通过链式写法的.fail()来完成，或者改用$.ajax()的error配置项。这是使用频率最高的一个坑。
误区二：忽略回调函数的静默失败。当服务器返回的内容不是合法JSON时，比如返回了HTML错误页面、纯文本提示语，或者JSON中存在多余的逗号，jQuery解析失败后既不执行成功回调，也不抛出直观的错误提示，代码看起来像什么都没发生。排查方法是在浏览器开发者工具的Network面板查看响应内容，确认返回的是否为严格合法的JSON字符串，特别注意不要有多余的逗号和未加引号的键名。
误区三：跨域请求的误解。getJSON本身受浏览器同源策略限制，如果请求的接口和当前页面不同源，会直接报CORS错误。不过getJSON有一个特殊能力：如果URL末尾加上callback=?这样的参数，jQuery会自动把请求转成JSONP方式，通过动态插入<script>标签来绕过同源限制。但这要求服务器端必须支持JSONP，也就是把数据包裹在回调函数里返回。如果服务端不支持，加了这个参数反而会导致语法错误。
// JSONP写法：末尾的 ? 会被替换成随机回调函数名
$.getJSON("https://other-domain.com/api/list?callback=?", function(data) {
console.log(data);
});如今处理跨域更推荐的做法是让服务端开启CORS响应头，配合普通请求使用，JSONP只支持GET且安全性较弱，逐渐被淘汰。另外还要提醒一点：如果接口地址使用了https，页面却是http协议，浏览器同样会拦截请求，这是混合内容限制，和getJSON本身无关。
总结
getJSON是一个简洁实用的数据获取方法，核心要点有三条：它是ajax的快捷封装，自动解析JSON；它没有error参数，错误处理要用.fail()；跨域时可以通过JSONP参数实现，但前提是服务端支持。掌握了这些细节，再遇到回调不执行的问题，就能顺着数据格式、请求状态、跨域策略这几条线索快速定位原因。
jQuery getJSONAJAX请求跨域问题修改时间：2026-09-04 23:02:39