本教程探讨了jQuery AJAX中加载动画不显示的问题，核心原因在于使用`async: false`导致同步请求阻塞了浏览器UI渲染。通过将`async`参数设置为`true`（或移除，因其为默认值），可以确保AJAX请求以异步方式执行，从而允许加载动画正常显示，提升用户体验和界面响应性。
在Web应用开发中，通过AJAX（Asynchronous JavaScript and XML）异步加载数据是提升用户体验的关键。当数据加载需要一定时间时，通常会显示一个加载动画（如GIF图片或CSS动画）来告知用户操作正在进行中，避免界面假死。然而，有时即使代码逻辑看似正确地在请求前显示加载器，在请求结束后隐藏加载器，加载动画依然不显示，并且控制台也没有报错。这通常指向一个关于AJAX请求模式的深层问题。
问题现象与初步分析
开发者在按钮点击事件中触发一个函数，该函数内部包含一个jQuery AJAX请求来获取数据。在AJAX请求开始前尝试显示一个加载动画（$('#imgLoader').show()），在请求成功或失败后隐藏它（$('#imgLoader').hide()）。然而，实际运行中，加载动画并未如预期般显示，用户界面在数据加载期间显得无响应。
原始代码片段如下：
function fnLoadVendorData() {
var vendorSel = $("#ddlVendorName option:selected").text();
var strCircle = $("#lblRole").text();
if (vendorSel != "--Select Vendor--" && typeof (vendorSel) != 'undefined') {
$.ajax({
type: "POST",
url: "Ipfee.aspx/GetVendorData",
data: JSON.stringify({ "vendorName": vendorSel, "strCircle": strCircle }),
contentType: "application/json; charset=utf-8",
dataType: "json",
async: false, // 关键所在
success: function (response) {
if (response.d != "NoDataFound") {
$('#imgLoader').show(); // 这里显示加载器可能已经太晚
var getDatalist = JSON.parse(response.d);
Create_vendorDataTable(getDatalist);
$('#imgLoader').hide();
} else {
jAlert("Data not available !!", "Information");
}
$('#imgLoader').hide();
},
error: function (response, textStatus, errorThrown) {
jAlert(textStatus, "Information");
}
});
}
}核心原因：同步AJAX请求
问题的根源在于jQuery AJAX配置中的async: false参数。这个参数指示浏览器以同步方式执行AJAX请求。
当async设置为false时，JavaScript代码会暂停执行，直到AJAX请求完成并从服务器接收到响应。这意味着：
- 浏览器的主线程被阻塞。
- 在请求完成之前，浏览器无法执行任何其他任务，包括更新UI、处理用户输入或渲染DOM变化。
即使在AJAX请求之前调用了$('#imgLoader').show()，由于主线程被阻塞，浏览器也没有机会在请求返回之前重新渲染页面，从而使加载动画无法显示。用户看到的是一个冻结的界面，直到数据加载完毕，加载动画才可能瞬间出现并立即消失，或者根本不出现。
解决方案
解决此问题的关键是将async参数设置为true，或者直接移除该参数，因为async: true是jQuery AJAX的默认行为。
将AJAX请求改为异步执行后，浏览器的主线程将不会被阻塞。当请求发出后，JavaScript代码会继续执行，允许浏览器更新UI并显示加载动画。当服务器响应返回时，success或error回调函数才会被触发。
修改后的代码示例如下：
function fnLoadVendorData() {
var vendorSel = $("#ddlVendorName option:selected").text();
var strCircle = $("#lblRole").text();
if (vendorSel !== "--Select Vendor--" && typeof (vendorSel) !== 'undefined') {
// 在AJAX请求发起前显示加载器
$('#imgLoader').show();
$.ajax({
type: "POST",
url: "Ipfee.aspx/GetVendorData",
data: JSON.stringify({ "vendorName": vendorSel, "strCircle": strCircle }),
contentType: "application/json; charset=utf-8",
dataType: "json",
async: true, // 将async设置为true，或直接移除此行
success: function (response) {
if (response.d !== "NoDataFound") {
var getDatalist = JSON.parse(response.d);
Create_vendorDataTable(getDatalist);
} else {
jAlert("Data not available !!", "Information");
}
},
error: function (response, textStatus, errorThrown) {
jAlert(textStatus, "Information");
},
complete: function() {
// 无论成功或失败，都在请求完成后隐藏加载器
$('#imgLoader').hide();
}
});
}
}重要提示： 在上述修改中，我们将$('#imgLoader').show();移到了$.ajax调用之前，确保在请求发送时加载器立即显示。同时，为了确保加载器在请求完成后无论成功与否都能被隐藏，我们引入了complete回调函数。complete回调会在success和error回调之后执行。
最佳实践与注意事项
- 优先使用异步请求： 在绝大多数Web开发场景中，都应优先使用异步AJAX请求（async: true）。同步请求会严重影响用户体验，导致页面卡顿、无响应。
- 避免在UI线程中执行耗时操作： 除了AJAX，任何长时间运行的JavaScript代码都可能阻塞UI。应尽量将耗时计算分解或使用Web Workers在后台线程中执行。
-
加载器显示时机： 确保加载动画在请求发送前立即显示，并在请求完成（无论成功或失败）后隐藏。使用beforeSend和complete回调是管理加载器状态的良好实践：
$.ajax({ // ... 其他配置 beforeSend: function() { $('#imgLoader').show(); // 请求发送前显示 }, success: function(response) { // ... 处理成功响应 }, error: function(jqXHR, textStatus, errorThrown) { // ... 处理错误 }, complete: function() { $('#imgLoader').hide(); // 请求完成后隐藏 } }); - 用户体验： 提供清晰的加载指示，让用户了解应用正在处理请求，从而减少等待时的焦虑感。
- 服务端响应时间： 优化后端API的响应时间也是提升整体用户体验的关键。即使前端处理得再好，过长的服务器响应时间依然会影响用户感知。
总结
当jQuery AJAX加载动画不显示且没有报错时，首先应检查async参数的设置。async: false是导致UI阻塞和加载动画无法渲染的常见原因。通过将AJAX请求改为异步模式，不仅能解决加载动画显示问题，更能显著提升Web应用的响应性和用户体验。在现代Web开发中，始终推荐使用异步操作来保持界面的流畅性。
