unref用于让定时器或i/o句柄不再阻止进程退出，适用于后台任务；2. ref则重新使其能阻止退出，恢复对事件循环的影响；3. 核心在于控制事件循环的“活跃句柄计数器”，不改变句柄本身运行；4. 典型场景如心跳定时器、日志上传器，避免非核心任务绑架进程生命周期；5. 注意陷阱：unref不清理资源、误用会导致意外退出、调试困难、仅适用于创建底层句柄的api。
Node.js中的
unref
和
ref
方法，它们的核心作用在于精妙地控制事件循环的生命周期。简单来说，
unref
允许某个定时器或I/O句柄在后台运行，但不再被视为“活跃”的，这意味着如果它是事件循环中唯一剩下的东西，进程就会优雅地退出。而
ref
则恰好相反，它将之前被
unref
的句柄重新标记为“活跃”，使其再次能够阻止进程退出。这就像给事件循环的“派对”设置了一个最低参与人数：
unref
就是让某位参与者可以悄悄离场，不再计入这个人数，而
ref
则是把他重新拉回计数。
解决方案
理解
unref
和
ref
，首先得搞清楚Node.js事件循环的运作逻辑。事件循环会持续运行，只要它检测到有“活跃”的句柄（handles）存在。这些句柄通常包括网络连接（如TCP服务器或客户端套接字）、定时器（
setTimeout
,
setInterval
）、文件系统监视器等等。它们是Node.js进程得以维持运行的“生命线”。
unref()
方法，当应用于一个句柄时，会告诉Node.js：“嘿，这个句柄虽然还在工作，但它不再是保持进程活着的必要条件了。如果所有其他被‘引用’的句柄都完成了，那么即使这个
unref
的句柄还在，进程也可以安全地退出了。” 这对于那些你希望它们能运行，但又不希望它们“绑架”整个应用生命周期的后台任务来说，简直是神来之笔。比如，一个后台的日志上传器，或者一个偶尔的心跳检测，你当然希望它们能跑，但如果主服务都停了，它们也没必要强撑着不让进程退出。
而
ref()
方法，顾名思义，就是
unref()
的逆操作。如果你之前
unref()
了一个句柄，但后来又决定它应该重新获得阻止进程退出的能力，那就调用
ref()
。这就像是给了它一张“VIP通行证”，让它重新回到事件循环的“重要人物”列表里。
这俩方法，说白了，就是让你对Node.js进程的退出时机有了更细粒度的控制。不是所有后台任务都值得为它们牺牲进程的优雅退出。
Node.js事件循环的内部机制是什么？unref和ref如何与之交互？
Node.js的事件循环，我常把它想象成一个不停旋转的轮盘，上面分了好几个区域：定时器（timers）、待处理的回调（pending callbacks）、闲置/准备（idle, prepare）、轮询（poll）、检查（check）、关闭回调（close callbacks）。每个区域都处理特定类型的事件。事件循环会不断地检查这些区域，看看有没有待处理的任务。
关键在于，事件循环在每次迭代结束时，会检查一个内部的“活动句柄计数器”。只要这个计数器大于零，事件循环就会继续下一轮。每个被创建并“引用”的句柄，比如一个
setTimeout
返回的对象，或者一个
net.Server
实例，都会让这个计数器加一。当这些句柄完成任务或被关闭时，计数器会减一。
unref
和
ref
就是直接作用于这个“活动句柄计数器”的。当你对一个句柄调用
unref()
时，Node.js会将其从“阻止进程退出的句柄列表”中移除。它并没有停止句柄本身的运作（比如定时器依然会计时，套接字依然会监听），只是在事件循环判断“我是否该退出了？”的时候，不再把这个句柄考虑在内。如果所有其他“被引用”的句柄都处理完了，进程就会退出，即便那些
unref
的句柄还在“默默工作”。
反之，
ref()
就是把一个之前被
unref
的句柄重新加回这个列表。这有点像一个内部的“软删除”和“恢复”操作，它不影响句柄的生命周期管理，只影响它对进程生命周期的影响力。这种机制，对于需要后台持续运行但又不想“绑架”主进程的应用场景，简直是量身定制。
什么时候应该使用unref和ref方法？它们有哪些实际应用场景？
在实际开发中，
unref
和
ref
并非日常高频使用的API，但一旦遇到特定场景，它们就能帮你解决大问题。
一个典型的应用场景是后台任务。设想你有一个Node.js服务，它除了处理Web请求，可能还需要定期向某个外部API发送心跳包，或者收集一些运行指标并上传。这些任务通常通过
setInterval
来完成。如果这些
setInterval
不被
unref
，那么即使你的Web服务器已经关闭，或者所有活跃的客户端连接都断开了，Node.js进程也会因为这些后台定时器而一直挂着，不肯退出。这时候，你就可以对这些定时器调用
unref()
。
const http = require('http'); const server = http.createServer((req, res) => { res.writeHead(200, { 'Content-Type': 'text/plain' }); res.end('Hello Worldn'); }); server.listen(3000, () => { console.log('Server running on port 3000'); // 这是一个后台任务，每2秒打印一次日志 const backgroundLogger = setInterval(() => { console.log('后台任务：正在记录一些东西...'); }, 2000); // 我们不希望这个后台任务阻止进程退出 // 当所有活跃连接都关闭，或者服务器被明确关闭时，进程应该能够退出 backgroundLogger.unref(); console.log('后台日志定时器已unref。'); // 当服务器关闭时，清除定时器是好习惯，但即使不清除，因为unref了，进程也能退出 server.on('close', () => { console.log('HTTP服务器已关闭。'); clearInterval(backgroundLogger); // 显式清除，虽然unref已让它不阻碍退出 }); }); // 模拟外部关闭信号，比如在实际应用中可能是PM2或Docker发送的SIGTERM // setTimeout(() => { // console.log('模拟关闭服务器...'); // server.close(() => { // console.log('服务器关闭回调执行完毕。'); // }); // }, 10000);
在这个例子里，如果
backgroundLogger
没有
unref
，当你调用
server.close()
后，进程仍然会因为
backgroundLogger
的存在而继续运行。但有了
unref
，一旦
server
关闭且没有其他活跃句柄，进程就会干净利落地退出。
另一个例子可能是长时间不活跃的数据库连接池。某些连接池可能会有一个内部定时器，用于清理空闲连接。你可能希望这些定时器在没有活跃查询时，不阻止应用程序的优雅关闭。
总的来说，当你有一个“辅助性”或“非核心”的异步操作，它需要持续运行，但它的生命周期不应该与整个Node.js进程的生命周期强绑定时，
unref
就派上用场了。
unref和ref方法在使用时有哪些潜在的陷阱或需要注意的事项？
虽然
unref
和
ref
非常有用，但它们并非没有“脾气”。用不好，可能会带来一些意想不到的麻烦。
首先，误解“引用”状态。
unref
并不是让你的句柄被垃圾回收，它只是改变了该句柄对事件循环“是否保持活跃”判断的影响。句柄本身依然存在，依然会执行其回调。如果你
unref
了一个
setInterval
，但忘记在适当的时候
clearInterval
，它会一直在后台跑，消耗资源，只是不阻止进程退出而已。这就像你把一个电器插头拔了（进程退出），但电器内部的电池还在工作（unref的定时器还在跑）。
其次，过度
unref
可能导致意外退出。如果你不小心
unref
了核心服务监听器（比如
http.Server
的实例），那么当你的应用没有其他被引用的句柄时，它可能会在没有任何警告的情况下直接退出。这在调试时会非常头疼，因为你根本不知道为什么进程就“消失”了。所以，一定要非常清楚你正在
unref
的是什么。
再者，调试难度增加。当进程行为不符合预期（比如过早退出或持续挂起）时，如果存在
unref
的句柄，排查问题会变得更复杂。你可能需要借助Node.js的一些内部工具，比如
process._getActiveHandles()
（注意，这是内部API，不建议在生产环境中使用），来查看当前哪些句柄是活跃的，哪些是被
unref
的。
最后，
unref
和
ref
不是万能药。它们只适用于那些会创建底层句柄并影响事件循环生命周期的API。例如，一个简单的
Promise
链或者
process.nextTick
回调并不会创建这样的句柄，因此它们不会阻止进程退出，也就不需要
unref
。理解它们的作用范围，避免在不适用的地方画蛇添足，也是很重要的。
总结一下，这两个方法是Node.js事件循环控制的利器，但使用时务必谨慎，清晰理解其背后的机制，才能真正发挥它们的价值，避免引入新的问题。
评论（已关闭）
评论已关闭