Async Hooks是Node.js用于追踪异步资源生命周期的API，通过init、before、after、destroy等回调监控资源创建与销毁，可实现上下文传递与请求链路追踪。
JavaScript 的异步钩子（Async Hooks）是 Node.js 提供的一个强大 API，用于追踪异步操作的生命周期。它能帮助开发者监控资源的创建、执行和销毁过程，非常适合用于性能分析、调试、日志追踪或实现上下文传递（如链路追踪）。以下是使用 Async Hooks 进行异步资源追踪的核心方法。
什么是 Async Hooks？
Async Hooks 是 Node.js 的内置模块，允许你在异步资源的整个生命周期中注册回调函数。这些资源包括定时器、Promise、TCP 连接、文件 I/O 等。通过 async_hooks 模块，你可以监听以下关键阶段：
- init：异步资源刚被创建时触发
- before：异步回调执行前触发
- after：异步回调执行后触发
- destroy：异步资源被销毁时触发
- promiseResolve：Promise 的 resolve 被调用时触发（可选）
如何创建一个基本的异步追踪器？
下面是一个使用 async_hooks 实现简单异步资源追踪的示例：
const async_hooks = require('async_hooks');
// 存储每个异步资源的上下文
const store = new Map();
// 创建 AsyncHook 实例
const hook = async_hooks.createHook({
init(asyncId, type, triggerAsyncId) {
// 继承父上下文（例如从 Promise 或 setTimeout 触发）
const currentId = async_hooks.executionAsyncId();
const parentContext = store.get(currentId);
if (parentContext) {
store.set(asyncId, { ...parentContext });
}
},
destroy(asyncId) {
store.delete(asyncId);
},
before(asyncId) {
// 可选：记录进入异步回调前的操作
},
after(asyncId) {
// 可选：记录退出异步回调后的操作
}
});
// 启用钩子
hook.enable();
// 辅助函数：设置当前上下文数据
function setCurrentContext(key, value) {
const id = async_hooks.executionAsyncId();
const context = store.get(id) || {};
context[key] = value;
store.set(id, context);
}
// 辅助函数：获取当前上下文数据
function getCurrentContext(key) {
const id = async_hooks.executionAsyncId();
const context = store.get(id);
return context ? context[key] : undefined;
}
实际应用：追踪请求上下文
一个典型用途是在处理 HTTP 请求时保持追踪上下文，比如记录用户 ID 或请求 ID。例如：
立即学习“Java免费学习笔记（深入）”；
const http = require('http');
const server = http.createServer((req, res) => {
// 设置请求级别的上下文
setCurrentContext('requestId', generateRequestId());
setCurrentContext('url', req.url);
// 模拟异步操作（如数据库查询）
setTimeout(() => {
console.log('Current context in timeout:', {
requestId: getCurrentContext('requestId'),
url: getCurrentContext('url')
});
res.end('OK');
}, 10);
});
server.listen(3000);
在这个例子中，即使在 setTimeout 的回调中，也能访问到原始请求的上下文信息，这得益于 Async Hooks 在 init 阶段自动继承了父上下文。
注意事项与限制
- Async Hooks 对性能有一定影响，不建议在生产环境长期开启，除非用于监控工具
- 并非所有异步操作都能被精确追踪（如某些原生 C++ 层调用）
- Promise 的 init 和 destroy 可能不会成对出现，需谨慎处理内存泄漏风险
- Node.js 版本需支持 Async Hooks（v8.1.0+），且 API 稳定性标记为“experimental”但广泛使用
基本上就这些。通过合理使用 Async Hooks，你可以构建强大的异步上下文追踪系统，为日志、监控和诊断提供有力支持。虽然底层机制复杂，但封装后可以非常实用。
