1. 别再说"回调地狱"了,async/await 才是异步的正确打开方式
先问一个直击灵魂的问题:你写异步代码的时候,是不是还在用 .then() 链一层层嵌套?或者还在用回调函数一个套一个,最后自己看着都头疼?如果你点进来,说明你已经在为一个非常核心的问题烦恼了——异步编程到底怎么写才优雅。
这不是某个小框架的奇技淫巧,而是从 Node.js 到浏览器前端,从 Python 到 Rust,几乎所有现代语言都在用的一套编程范式。async/await 就是异步编程的语法糖天花板——它让你用写同步代码的姿势,去处理异步逻辑,丢掉回调、丢掉 .then() 链,直接把"先做什么、再做什么"按顺序平铺在代码里,阅读起来就像在读一篇流程说明书。
这项技术解决的核心痛点非常明确:异步代码的可读性、可维护性、错误处理复杂度。你以为你缺的是写异步的语法?不,你缺的是一套从事件循环到 Promise 底层机制都吃得透的心法。这篇博文我打算从"为什么异步代码这么难写"讲起,逐步拆解事件循环、Promise、async/await 的底层关系,再给出一套可以直接抄作业的实操方案,最后聊聊我在真实项目里踩过的坑。
适合谁看?刚接触异步编程的新手、被嵌套回调折磨的中级开发者,以及想系统梳理自己异步知识体系的进阶玩家。不需要你有多深的基础,但如果你曾为"为什么这个 await 没生效""为什么这里会死锁""并发请求怎么控制"这些问题头疼过,这篇文章就是给你准备的。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 异步编程的底层逻辑:为什么同步代码改异步这么难
2.1 从"排队打饭"到"叫号取餐":异步的本质是调度
理解异步,最简单的方式是拿食堂打饭来类比。同步编程像什么?像五十个人排成一队,前面的人没打完饭,后面的人就得一直等着。你点了红烧肉,师傅做到一半发现没酱油了,去仓库拿酱油,这时候你站在窗口干等,后面所有人也跟着干等。这就是同步阻塞——一个任务没完成,后面的任务全部卡住。
异步编程像什么?像快餐店的叫号系统。你点完餐,拿一个号,先去找座位、刷手机、喝饮料,等厨房做好了你那单,广播叫号,你再去取餐。这中间你去刷手机、喝饮料的"时间",就是异步程序去处理其他任务的时间。没有人在空等,CPU 没有在空转,所有任务都在推进。
在编程语言层面,这个机制叫事件循环(Event Loop)。JavaScript 是单线程的,但它靠事件循环实现了"伪多线程"的并发效果——把耗时的 I/O 操作(网络请求、文件读取、数据库查询)扔给底层,然后继续执行后面的代码,等底层完成了,再把回调塞进任务队列里排队执行。
Python 的 asyncio 也是类似的设计。虽然 Python 有多线程和多进程,但 GIL 锁的存在让多线程在 CPU 密集型任务上很吃亏,而 asyncio 用单线程加事件循环的方式,在 I/O 密集型任务上能跑出非常漂亮的性能。
这里有个关键点:异步不是并发执行的升级版,而是交错执行的艺术。程序没有在同一时刻做两件事,它只是在一个任务等待的时间里,切换去做了另一件事。CPU 资源没有被浪费,但你得接受一个事实:你的代码执行顺序不再是从上到下老老实实走的。
2.2 回调函数为什么是"毒药":不只是脏,更是反人类的控制流
在没有 async/await 的时代,写异步代码靠的是回调函数。所谓回调,就是"你做完这件事之后,记得调用我给你的这个函数"。
看这段典型的 Node.js 风格代码:
javascript复制fs.readFile('a.txt', 'utf8', function(err, dataA) {
if (err) throw err;
fs.readFile('b.txt', 'utf8', function(err, dataB) {
if (err) throw err;
fs.readFile('c.txt', 'utf8', function(err, dataC) {
if (err) throw err;
console.log(dataA + dataB + dataC);
});
});
});
三个文件的读取就要嵌套三层。五个依赖操作就嵌套五层。如果中间还要穿插条件判断、循环、异常处理,那就更精彩了——缩进越来越深,代码越来越往右偏,就像一座比萨斜塔。这被社区称为回调地狱(Callback Hell)。
回调地狱的本质问题不只在于"难看",更在于它把程序的控制流打碎了。你没法用 try/catch 捕获回调里的异常,因为回调函数是异步执行的,它不在你的调用栈上。你没法用一个 for 循环去遍历请求,因为回调的执行时机不可控。你甚至没法简单地判断"三个文件都读完了",因为没有一个统一的"完成"信号。
所以 Promise 的诞生不是为了好看,而是为了重新建立异步场景下的控制流。它让你能表达"要么成功、要么失败"的二元状态,让你能用 .then() 把回调整平成一条链。但 .then() 链也有它的极限——当你要表达复杂的业务逻辑时,链式调用并不比回调嵌套容易读。
2.3 Promise 到底是什么:一部状态机
进入 async/await 之前,有个绕不开的基础:Promise。如果你连 Promise 都搞不清楚,写 async/await 大概率是"知其然不知其所以然",遇到复杂场景就容易翻车。
Promise 的本质是一个状态机。它有三种状态:
- pending(进行中):初始状态,操作还没完成。
- fulfilled(已成功):操作完成,有结果值。
- rejected(已失败):操作失败,有失败原因。
状态一旦从 pending 变成 fulfilled 或 rejected,就永久凝固,不可再变。这个特性保证了 Promise 的结果是确定的——要么成功拿到数据,要么失败拿到错误,没有中间态。
你可能会问:回调函数也能表达成功和失败啊,为什么 Promise 更优?因为 Promise 把"异步结果"变成了"一个对象,一个值",你可以把它存在变量里、塞进数组里、作为函数返回值传递。回调做不到这一点——回调的执行时机和传递路径完全分离,你没法随手把一个回调结果交给另一个函数继续处理。
Promise.all、Promise.race、Promise.allSettled 这些静态方法,都是在"Promise 是值"的基础上设计的。我可以把三个文件的读取分别封装成三个 Promise,然后 Promise.all 一把梭,全部成功才算成功——这在回调时代是要写状态计数器的,贼痛苦。
3. async/await 完全解读:从语法糖到执行机制
3.1 async 函数:一个隐式返回 Promise 的"魔法"函数
先看一个最简单的例子:
javascript复制async function getData() {
return 'hello';
}
const result = getData();
console.log(result); // Promise {<fulfilled>: 'hello'}
注意,getData() 的执行结果不是 'hello' 这个字符串,而是一个 Promise 对象。这就是 async 关键字的第一个作用:让函数的返回值变成一个 Promise。哪怕你返回的是一个普通值,它也会被你包进一个 fulfilled 状态的 Promise 里。
这个特性意味着什么?意味着所有 async 函数都可以被 .then() 或 await 消费——它们之间是天然兼容的。你在某处定义了一个 async function,在另一个地方可以用 await getUserInfo() 去等待它,或者用 getUserInfo().then(res => ...) 去链接。异步代码的"积木"形状统一了。
那 async 函数内部如果抛异常呢?比如:
javascript复制async function broken() {
throw new Error('boom');
}
broken().catch(err => console.log(err.message)); // 'boom'
异常不会被静默吞掉,它会变成返回的 Promise 的 rejected 状态。这比回调时代的 throw 不知道强到哪去了——你在回调里 throw 一个异常,十有八九会被吞掉或者直接让进程崩溃,但在 async 函数里,throw 和 return 一样,都是"状态转换"的触发方式,可被捕获。
3.2 await 运算符:暂停函数,但不阻塞线程
await 是另一个关键。它的作用是:暂停当前 async 函数的执行,等待一个 Promise 决出结果,然后继续往下走。
但这里有个很多人误解的点:await 会阻塞整个程序吗? 不会。它只暂停当前 async 函数的执行,事件循环还是活的,其他任务照常跑。
看这个例子:
javascript复制async function test() {
console.log('开始');
const start = Date.now();
await new Promise(resolve => setTimeout(resolve, 2000));
console.log('2秒过去了', Date.now() - start);
}
async function main() {
test();
console.log('main 函数继续执行');
}
main();
// 输出顺序:
// 开始
// main 函数继续执行
// 2秒过去了 2000
注意,test() 被调用后并没有阻塞 main 的执行。它先把"开始"打印出来,然后遇到 await,控制权交还给事件循环,main 里的下一行立刻执行。等 2 秒后定时器到了,Promise resolve,函数从暂停处恢复继续跑。
这背后的机制是:await 会把函数剩余的部分打包成一个微任务(microtask),挂到微任务队列里。事件循环在处理完当前同步代码段之后,会回头处理这些微任务。所以你看到的执行顺序,本质上是同步代码 -> 微任务 -> 宏任务(定时器的回调就是宏任务)的调度结果。
其实从 ECMAScript 规范的视角看,async/await 可以被"降级"为 Promise + generator 的组合。await 就像 generator 的 yield,暂停执行、交出控制权,然后由外部调度器在 Promise settle 后把它恢复。理解这个层面,你就知道为什么 await 只能在 async 函数里用了——它需要一个"外部调度器"来驱动,而 async 函数就是那个自带驱动器的执行环境。
3.3 async/await 之于 Error Handling:终于可以 try/catch 了
Promise 时代你处理异常要靠 .catch(),链式调用一复杂,catch 的位置也容易放错。async/await 最大的红利就是你熟悉的 try/catch 终于回来了。
javascript复制async function loadUserData() {
try {
const user = await getUserFromDb();
const orders = await getOrdersByUser(user.id);
return orders;
} catch (err) {
console.error('加载用户订单失败:', err);
return [];
}
}
这里有三板斧的体验升级:第一,代码读起来和同步代码完全一致;第二,getUserFromDb 如果 reject,会直接跳到 catch 里,不需要中途插 .catch();第三,你可以把多个 await 包在同一个 try 块里,任何一个失败都会进 catch,统一处理。
有一个小细节要注意:await 只能捕获 promise 的 rejected 状态。如果 promise 永远 pending,那 await 就会一直等下去,既不往下走,也不报错。所以凡是用到 await 的地方,如果你的 Promise 可能会永不落定,记得加超时兜底——这个我在后面的坑位清单里展开说。
4. 核心误区与底层差异:await 不是"同步等待"
4.1 await 的"暂停"是给别的任务让路,不是卡死
我见过太多人把 await 理解成"把异步变成同步"。从代码表面上写起来确实像同步,但底层完全不是一回事。
前文已经说过,await 暂停的是当前的 async 函数,而不是整个进程。它会把控制权交还给事件循环,让其他任务利用这段"等 I/O"的时间继续推进。如果你把 await 理解成"卡住等你完成",那么你一定会写出阻塞大量并发任务的代码。
来一个典型的反面教材——在循环里串行 await:
javascript复制async function loadAllUsers(userIds) {
const results = [];
for (const id of userIds) {
const user = await fetchUser(id); // 一个接一个,串行执行
results.push(user);
}
return results;
}
这段代码没有语法错误,但性能是灾难性的。如果 fetchUser 是一个 200ms 的网络请求,id 有 10 个,总耗时就是 2000ms。这 10 个请求没有任何依赖关系,完全可以同时发出去,为什么要一个一个等?
正确的姿势是让它们并发执行:
javascript复制async function loadAllUsers(userIds) {
const promises = userIds.map(id => fetchUser(id)); // 立刻发起所有请求
return await Promise.all(promises); // 等待全部完成
}
这里有个极其重要的概念:Promise 在创建的那一刻就开始执行了,不需要等 await。你把 fetchUser(id) 放进一个数组时,网络请求已经发出去了,Promise.all 只是负责"等齐"而已。很多新手以为"要等到 await 的那一行才开始执行",这是个致命误解。
4.2 for await...of:处理集合型异步的利器
如果说 Promise.all 解决的是"平铺并发",那 for await...of 解决的则是"迭代序列"里的异步消费。我举个例子:从数据库游标里逐条读取数据、逐条处理,这种场景你没法一次性把所有数据拉出来,因为可能上百万条。你拿到的是一个异步迭代器(async iterable)。
javascript复制async function processRecords(gen) {
let count = 0;
for await (const record of gen) {
await saveToReport(record); // 每条记录都异步保存
count++;
}
return count;
}
for await...of 会依次从异步迭代器中取出元素,每取一个就 await 一次。它比"在循环里手动 await"更安全的点在于:它把异步迭代器的终止条件(done: true)也处理成了异步判断。你自己手动写 while 循环去调 next(),很容易漏掉最后一条记录。
值得一提的还有 Promise.allSettled。它和 Promise.all 的区别是:all 是"全对才算对,一个错就整体错",allSettled 是"不管成败,都告诉你结果"。在处理多条相互独立的异步任务时,我强烈建议用 allSettled——因为一条数据的失败不应该拖垮整个批处理任务。
4.3 async/await 在事件循环里的真实执行时机
你知道这段代码的输出顺序吗?
javascript复制setTimeout(() => console.log('timeout'), 0);
const p = Promise.resolve();
p.then(() => console.log('microtask'));
(async () => {
console.log('async start');
const r = await p;
console.log('async after await', r);
})();
console.log('sync code');
正确答案是:
code复制async start
sync code
microtask
async after await
timeout
很多人会栽在 "async after await" 的位置上。这里的关键是 await p——这里的 p 已经是一个 fulfilled 的 Promise,但 await 依然会让出执行权,把后续代码作为另一个微任务排在 p.then 的回调之后。
所以你会发现:执行顺序的确定性,从不靠"我觉得",而靠事件循环的队列规则。宏任务(setTimeout)、微任务(Promise.then/await 的恢复)各有各的队列,同一类任务内部按先进先出,宏任务和微任务的优先级是固定的——微任务永远先于宏任务。
如果你在写一个对时序敏感的应用(比如动画过渡、多阶段请求),这个输出顺序是必须刻进脑子里的。
5. 完整实操:从 0 到 1 写一个高可用的异步请求模块
5.1 需求拆解:我们要解决的问题是什么
理论讲了这么多,不如端一盘实操上来。我打算带你写一个带并发限制、超时控制、自动重试的请求模块。这三个能力是真实业务里最常见的三个需求:
- 并发限制:不限制的话,一次性发 100 个请求,网络直接打爆,服务器也要报警。
- 超时控制:万一某个请求卡住了,不能让它无限期占用连接池。
- 自动重试:网络抖动、服务临时过载,重试一次往往就好了,不用整个任务失败。
这个模块在 Node.js 环境用 fetch(Node 18+ 内置)实现,在浏览器环境也基本兼容。它是你理解 async/await 真实用法的绝佳练习——因为每一个环节都会用到 Promise 的控制能力。
5.2 第一步:超时控制的 Promise 竞速实现
超时控制最经典的实现方式是 Promise.race——你自己实现一个"延时 reject"的 Promise,和真正的请求 Promise 赛跑,谁先完成谁说了算。
javascript复制function withTimeout(promise, ms) {
let timer;
const timeoutPromise = new Promise((_, reject) => {
timer = setTimeout(() => reject(new Error(`请求超时: ${ms}ms`)), ms);
});
return Promise.race([promise, timeoutPromise]).finally(() => {
clearTimeout(timer); // 防止定时器泄漏
});
}
注意几个细节:finally 里必须 clearTimeout,否则请求 100ms 就返回了,但定时器还挂着 5000ms,白白占着一个定时器资源,高并发下这是会堆积的。另外,timeoutPromise 一旦 reject,如果请求本身后来 settle 了,会出现一个未被处理的 Promise rejection——所以最好在 promise 后面挂一个空的 .catch(() => {}) 来吞掉,或者用 finally 规避。这里我为了代码清晰选择了不挂 catch,但真实项目里我会加。
5.3 第二步:并发限制的队列调度器
并发限制是这个模块的核心。最常见的思路是维护一个任务池:最多同时跑 N 个任务,任务完成一个,从待执行队列里补一个进来。这就是"滑动窗口"的思路。
javascript复制async function runWithConcurrency(tasks, limit) {
const taskQueue = [...tasks]; // 拷贝一份,避免修改原数组
const workers = [];
for (let i = 0; i < Math.min(limit, taskQueue.length); i++) {
workers.push(runWorker(taskQueue));
}
return await Promise.all(workers);
}
async function runWorker(queue) {
while (queue.length > 0) {
const task = queue.shift();
await task();
}
}
这个实现非常简洁:每个 worker 是一个 while 循环,只要队列里还有任务就取一个来执行。整个池子一共启动 limit 个 worker,于是任意时刻最多只有 limit 个任务在跑。任务之间互不干扰,每个 worker 的进度也不需要同步——队列自己就完成了协调。
有个容易忽略的小点:tasks 里的项目必须是"能返回 Promise 的函数",不能是 Promise 本身。如果是已经创建的 Promise,请求早就发出去跑了,并发限制不就失效了。所以任务列表存的是"惰性函数",调用的那一刻才真正发起请求。
5.4 第三步:自动重试 + 合并成完整模块
重试的逻辑不难,但有讲究。直接 catch 住再重新调用,简单粗暴,但遇到服务雪崩时反而会加重负担。标准做法是指数退避(Exponential Backoff):第一次失败等 200ms 重试,第二次失败等 400ms,第三次等 800ms,以此类推,把重试的压力摊开。
javascript复制async function fetchWithRetry(url, options = {}, retries = 3) {
let lastError;
for (let attempt = 0; attempt <= retries; attempt++) {
if (attempt > 0) {
const delay = Math.min(1000 * 2 ** (attempt - 1), 3000); // 指数退避,上限 3s
await sleep(delay);
}
try {
return await withTimeout(fetch(url, options), options.timeout || 5000);
} catch (err) {
lastError = err;
console.warn(`请求失败,第 ${attempt + 1} 次重试:`, err.message);
}
}
throw lastError;
}
function sleep(ms) {
return new Promise(resolve => setTimeout(resolve, ms));
}
把这三个能力组合起来,输出一个 requestAll 函数:
javascript复制async function requestAll(urls, { concurrency = 5, retries = 2, timeout = 5000 } = {}) {
const tasks = urls.map(url => () => fetchWithRetry(url, { timeout }, retries));
const results = await runWithConcurrency(tasks, concurrency);
return results;
}
使用的时候是这样的:
javascript复制const urls = ['https://api.example.com/a', 'https://api.example.com/b', /* ... */];
const data = await requestAll(urls, { concurrency: 3, retries: 2, timeout: 3000 });
这个模块的每一层都是异步编程核心能力的练习:withTimeout 用 Promise.race,并发队列用"惰性函数 + worker 池",重试用"循环 + await + sleep"。把它们拆开看都简单,组合在一起就形成了一个小小的、可直接复用的基础设施。
5.5 配套心得:Promise 是"值",async 函数是"容器"
写完了模块,我想分享一个我自己非常喜欢的心法:把 Promise 当作"值"来思考,把 async 函数当作"容器"来思考。
Promise 是一个"尚不确定、但终将确定的值"。这个视角特别有用——当你用 .map() 批量创建 Promise 时,你其实是创建了一个"值的数组",而不是"启动了数组个任务"。真正启动任务的是你调用它的时候。所以 Promise.all([]) 只是把一袋子"不确定的值"摊开打包,操作起来非常自然。
async 函数是一个"容器",它把一系列异步步骤按顺序包裹起来,内部通过 await 严丝合缝地衔接,外部看起来只是一个普通的 Promise。你可以把它当普通函数调用、传参、组合、放进数组。这种"函数即 Promise"的心智模型,是我认为从"会写"到"会设计"的关键跳跃。
6. 项目实战:一个带取消功能的异步任务管理器
6.1 为什么要做取消:真实场景里的硬需求
聊完通用模块,我来分享一个我在真实项目里做过的更完整的工具:可取消的异步任务管理器。
需求背景是这样的:在一个数据中台的前端管理界面里,用户经常要批量拉取几十个接口的数据,生成一份汇总报表。如果用户发现数据选错了,或者报表生成太慢想换参数重来,他点了一下"取消",结果请求还在继续发,资源还在消耗,最后数据回来了,界面却已经不是他想要的。这种体验非常差。
普通的 fetch 请求是支持 AbortController 取消的,但问题在于:当时的业务代码把多个请求裹在 Promise.all 里,还得做并发限制、重试、超时,取消逻辑根本没有一个干净的注入点。所以我做了一个 TaskManager,把取消能力做成"一个中止信号贯穿全程"。
6.2 实现思路:AbortSignal 是贯穿全程的"红绿灯"
AbortController 是浏览器和 Node 18+ 都支持的原生 API。它有两个核心成员:一个 signal 对象,一个 abort() 方法。你调用 abort(),signal 就会触发中止事件,任何监听它的请求都会取消。往异步代码里传 signal,就像在城市道路里放了一排红绿灯——取消请求就是在你想让所有任务停下来的路口把灯变红。
javascript复制class TaskManager {
constructor() {
this.controllerMap = new Map(); // 记录每个任务组的 controller
}
createTaskGroup(key) {
if (this.controllerMap.has(key)) {
this.controllerMap.get(key).abort(); // 新任务会打断旧任务
}
const controller = new AbortController();
this.controllerMap.set(key, controller);
return controller.signal;
}
cancelTaskGroup(key) {
const controller = this.controllerMap.get(key);
if (controller) controller.abort();
this.controllerMap.delete(key);
}
cancelAll() {
for (const controller of this.controllerMap.values()) {
controller.abort();
}
this.controllerMap.clear();
}
}
核心就一个 createTaskGroup(key)——同一个 key 的任务组,如果重复创建,上一次的会被自动 abort。这在"用户催生出多个并发查询"的场景里尤其好用:用户触发了一次查询,又触发了一次,旧查询自动取消,不会回来覆盖新数据。
6.3 与请求模块整合:一个 signal 贯穿始终
signal 不是只能用于 fetch,它还应该一级级传下去,让整个流程的每个环节都能感知"用户取消了"。我把之前的 fetchWithRetry 改造成支持 signal 的版本:
javascript复制async function fetchWithRetryAndSignal(url, options = {}, signal) {
let lastError;
for (let attempt = 0; attempt <= (options.retries || 2); attempt++) {
if (signal.aborted) {
throw new DOMException('任务已取消', 'AbortError');
}
if (attempt > 0) {
const delay = Math.min(1000 * 2 ** (attempt - 1), 3000);
await sleep(delay); // sleep 时要监听 signal
}
try {
const resp = await withTimeout(fetch(url, { ...options, signal }), options.timeout || 5000);
return await resp.json();
} catch (err) {
if (err.name === 'AbortError') throw err; // 取消异常不重试
lastError = err;
}
}
throw lastError;
}
在这个封装里,每次循环开始先检查 signal.aborted,如果是取消状态就直接抛 AbortError,跳出整个流程。重试时如果遇到取消,也立刻停止。这样你就不会在用户取消后还傻傻地重试三次——那是真正的浪费。
6.4 signal 与 sleep 的结合:不要让定时器"无视"取消
有个非常隐蔽的坑:如果重试前的 sleep 没有监听 signal,那么即使用户取消了,定时器还是会等满延迟时间才走下一步。在并发量大的场景,废掉的定时器资源不可忽视。所以 sleep 本身也要能感知取消:
javascript复制function sleepWithSignal(ms, signal) {
return new Promise((resolve, reject) => {
const timer = setTimeout(resolve, ms);
signal.addEventListener('abort', () => {
clearTimeout(timer);
reject(new DOMException('任务已取消', 'AbortError'));
}, { once: true });
});
}
这段代码的核心思想是:sleep 这个 Promise 的完成路径有两条——要么时间到了 resolve,要么 signal 中止了 reject。因为有了"取消状态"这个概念,程序就不必在做无谓的等待。async/await 本身就是对这种"事件驱动"的极致表达。
6.5 取消时如何不做"半截子"操作
有一个业务上的细节特别重要:取消后不要吞掉 AbortError。如果用户取消了任务,你就在 catch 里把这个异常吞掉,返回一个空结果,程序会以为"任务完成了,只是没数据"——这会让界面逻辑误判。
标准做法是"抛出但分类处理":AbortError 单独标记,走"用户主动取消"的提示分支;其他错误走"服务异常"的提示分支。前端接的是同一个 error,但可以根据 err.name === 'AbortError' 区分用户意图,给出"已取消"而不是"出错了"的文案。
这个 TaskManager 用下来,项目里"用户频繁切换查询条件导致旧结果覆盖新结果"的问题彻底解决。它说明一个道理:异步编程不仅仅是"怎么写并发",更是"怎么控制流程的生命周期"。你不仅要会开始任务,更要会优雅地结束任务。
7. 真实项目踩坑实录:那些文档里不会写的事
7.1 坑一:await 在嵌套函数里"失效"了
看这段代码,它期望的顺序是"先请求,再打印",但实际执行顺序完全不对:
javascript复制async function process() {
const cb = () => {
await fetch('/api/data'); // 语法错误或者不行
};
setTimeout(cb, 1000);
}
想在一堆代码里用 await 却"没法用",最常见的场景是 setTimeout 的回调里不能直接用 await。typeof 运算符一查,setTimeout 回调就是个普通函数,不是 async 函数,所以不能 await。要么把回调整个包成 async 函数,要么就得换思路。
javascript复制async function process() {
const run = async () => {
const res = await fetch('/api/data');
console.log(res);
};
setTimeout(run, 1000);
}
更隐蔽的版本是在数组回调里想用 await,比如 arr.forEach(async item => { ... })——注意 forEach 不会等待你返回的 Promise,所以这个循环是并发跑的,不是串行的。如果你要"一个接一个处理",必须用 for...of 外加 await。这是我见过的最多新手栽进去的坑。
7.2 坑二:Promise.all 的"一票否决"副作用
Promise.all 有个特性:任何一个 promise reject,整个 all 立即 reject,其他 promise 的结果会被丢弃。这在大多数场景下没问题,但有一个场景会踩坑:如果其中一个请求失败导致整个批处理失败,其他已经发出去的请求仍然在跑,但你"看不到"它们的结果了。
更狠的是,如果这些 promise 里有一个最终会 reject,而你没有给它们挂 catch,Node 进程甚至会因为 unhandled rejection 报警告,甚至退出。所以,Promise.all 不是保险箱,它有自己的容错策略要求。
我的建议是:只有当你真的认为"一个失败全部作废"是业务要表达的意思时,才用 Promise.all。 如果你要的是"每个任务有各自的成败,别互相拖累",用 Promise.allSettled 才是正解:
javascript复制const results = await Promise.allSettled([
fetch('/api/a'),
fetch('/api/b'),
fetch('/api/c'),
]);
for (const result of results) {
if (result.status === 'fulfilled') {
console.log('成功:', result.value);
} else {
console.log('失败:', result.reason);
}
}
每次要批量发请求前,先扪心自问一句:我到底需不需要"全有或全无"?大多数报表、列表一类的场景,其实全有或全无的需求很少,更多的是"能拉到多少是多少,失败的单独标红"。
7.3 坑三:把"循环里 await"写成"并发请求"引发数据库爆掉
这个坑我在服务端开发里踩过。当时要批量更新一万条用户数据的某个字段,我写了这样一段循环:
javascript复制for (const userId of userIds) {
await db.update(userId); // 一个接一个,但是每个都是数据库操作
}
这个版本的性能惨不忍睹,但是有一个更可怕的 "优化" 版本:
javascript复制userIds.forEach(async userId => {
await db.update(userId);
});
看起来"快"了很多,实际是给数据库下了"同时发起一万个 UPDATE"的命令。数据库连接池瞬间被占满,后续所有请求全部排队,数据库的负载直接飙到红线。这就是"用 forEach 发异步任务但完全不控制并发上限"的典型灾难。
教训是:并发不是你不用管的东西,它是你必须显式控制的资源。你在什么量级用哪种并发策略,必须想清楚。最小可用的并发控制方案,就是你开固定数量的 worker,让它们自己从队列里取任务——这就是我前面实现的 runWithConcurrency 要做的事情。永远别觉得 "forEach + async" 是一种并发写法,它只是"同时开火"的灾难写法。
7.4 坑四:微任务与宏任务的顺序坑
这是一个我前端同事踩过的真实问题。他用 async/await 写了这样一个动画逻辑:
javascript复制async function animate() {
element.classList.add('highlight');
await Promise.resolve(); // 想让浏览器"休息一下"好渲染高亮样式
element.classList.remove('highlight');
}
他以为 await Promise.resolve() 会让浏览器把高亮样式渲染出来,但这段代码的实际行为几乎和没有 await 一样——因为 await 一个已 resolve 的 Promise 不会让出事件循环,它只是把自己排到 microtask 队列。而浏览器的渲染发生在宏任务之后、下一个宏任务之前。如果你想强制让浏览器在下一个帧时机渲染,"正确的休息"是:
javascript复制async function animate() {
element.classList.add('highlight');
await new Promise(requestAnimationFrame); // 等下一帧渲染
element.classList.remove('highlight');
}
每次遇到"为什么样子没刷新"这种问题,先别怀疑你的 async/await,先想想你的"休息"到底切到了哪个队列。这个排查思路能帮你节省一整个下午。
8. 不同语言的 async/await:不是 JavaScript 的专利
8.1 Python 的 asyncio:事件循环是显式的
如果你也写 Python,会发现 Python 的 async/await 跟 JavaScript 有一个关键差异:事件循环是显式的。JavaScript 的 event loop 由引擎自动管理,你创建 Promise 它自己就跑了;Python 里你需要自己创建事件循环并显式运行:
python复制import asyncio
async def fetch_data():
await asyncio.sleep(1)
return "data"
async def main():
result = await fetch_data()
print(result)
asyncio.run(main()) # 显式创建并运行事件循环
asyncio.run() 是 Python 3.7+ 的推荐入口。它创建一个新的事件循环,运行你的协程,结束后自动关闭循环。Python 里的 asyncio.gather() 对应 JavaScript 的 Promise.all(),asyncio.wait_for() 对应 withTimeout,asyncio.Semaphore 可以控制并发上限。心智模型几乎一一对应。
8.2 其他语言:async/await 正在成为标配
不只是 JS 和 Python,async/await 已经是一套非常普适的编程心智模型。Rust 的 async/await 配合 tokio 运行时,写高性能网络服务几乎是标配;C# 从 5.0 开始就有 async/await,配合 Task.WhenAll,跟 Promise.all 一个思路;Dart(Flutter 的底层语言)也完全拥抱 async/await。
这套范式的优势在不同语言里高度一致:把"回调式"的控制流重新拉直为顺序式,同时保持底层并发能力不降级。你在这个心智模型上的投入,几乎可以在任何现代语言里复用——变的只是语法细节,不变的是一整套"该并发时并发、该等待时等待、该取消时取消"的思维框架。
所以我常说,学好 async/await 不是学某一个语言的语法,而是掌握编程世界里最核心的思维模式之一:面对不确定性,你的程序应该怎么组织。
9. 最后的经验之谈:从"会用"到"会设计"的三条建议
第一,先画清楚"任务依赖图",再写 async/await。动笔写代码之前,先用笔在纸上列出你的异步任务,哪些必须按顺序走(B 依赖 A 的结果),哪些可以并行(C 和 D 互不依赖),哪些要做失败兜底。画完这张图,你用 await 还是 Promise.all、要不要并发限制,自然就清楚了。算法能靠画流程解决问题,异步代码的流程控制更是如此。
第二,写异步代码时,永远思考"函数调用完的那一刻,发生了什么"。我在带新人时最常问的问题是:这个地方是 await 了还是没 await?你自己创建一个 promise,代码执行到这一行的时候,它已经开始跑了,还是只是定义好了?看起来是个小问题,但搞混了它,你会写出"该并发的串行了""该等待的提前走了"的代码。
第三,为你的异步代码写超时和取消的兜底。我在生产环境里见过太多"看起来很正常但一到高并发就崩"的异步代码,原因无一例外是:没有超时控制,没有取消机制,或者没有控制并发上限。你写异步代码的成熟度,很大程度上就体现在这三个兜底做没做全。牛不牛不看你怎么让任务跑起来——看你怎么让任务停下来。
聊透了。从一个"异步怎么写才优雅"的小问题出发,我们把事件循环、Promise、async/await、并发控制、取消机制这些核心概念全部盘了一遍,还手写了一套可用的请求模块和任务管理器。这套思维框架和代码模式,我已经在不同项目里反复验证过,效果都很稳定。你写异步代码的时候,别再把它当成"一种写法",把它当成一套完整的流程管理能力——从发起、到等待、到并发、到取消的每一个环节,都有设计,都有掌控。
