React 项目中 优雅停机 的设计取舍
前阵子把一个后台项目拆成微前端,结果用户切菜单的时候偶尔会弹两次全局通知。查了半天发现,子应用卸载后 WebSocket 没断,重连逻辑还在后台跑,等它连上又推了一次消息。那一刻我才认真想这件事:React 项目也得聊“优雅停机”,不是后端才有的词。
到底什么叫“停机”
在 React 里,停机不是一个进程退出那么简单,它可能是组件卸载、路由离开、页面关闭、微前端 unmount,或者 SSR 那层 Node 服务收到 SIGTERM。这些场景的共同点是:资源还有活着的引用,但使用方马上就要走了。你要决定哪些东西立刻掐掉,哪些等它跑完,哪些干脆留给下次启动补偿。
我一开始也觉得,useEffect 的 cleanup 写全不就行了。后来发现不是写不写全的问题,是“卸载时到底该不该等”的问题,这才是取舍。
取舍一:卸载时取消请求,还是让请求跑完
读请求我基本毫不犹豫地取消。路由都切走了,列表数据回来也没人接,不取消就是浪费连接,还可能触发卸载后的 setState。用 AbortController 很顺手:
useEffect(() => {
const ac = new AbortController();
fetch('/api/list', { signal: ac.signal }).catch((err) => {
if (err.name !== 'AbortError') report(err);
});
return () => ac.abort();
}, []);
但写请求不能这么干。用户点了提交,页面刚好卸载,你一个 abort 把请求掐了,后端可能已经落库,前端却以为失败,这就很难受。我的做法是:读请求卸载即取消,写请求交给全局队列或者允许它完成,页面关闭时再用 fetch 的 keepalive 或 sendBeacon 兜底。
不过 sendBeacon 也不是银弹,它有大小限制,不能随便加 header,返回结果你也拿不到。所以关键日志我一般做成后端幂等加本地补发,别指望关闭瞬间一定送达。这里的选择很现实:要么接受少量丢失,要么把链路做复杂。
取舍二:全局清理中心,还是组件自治
全局清理中心的好处是排查方便,定时器、WebSocket、全局事件都注册到一处,停机时统一跑一遍。坏处是侵入性强,写个组件还得记得去注册,新人很容易漏。
组件自治更自然,谁创建谁清理,但项目一大,总有几个 setInterval 藏在某个角落。我的折中是:基础资源用 hooks 封装,复杂一点的注册到管理器,开发环境卸载后检查残留。
const cleanups = new Set<() => void>();
export function registerCleanup(fn: () => void) {
cleanups.add(fn);
return () => cleanups.delete(fn);
}
export async function gracefulStop(timeout = 3000) {
const tasks = [...cleanups].map((fn) => Promise.resolve().then(fn));
await Promise.race([
Promise.allSettled(tasks),
new Promise((resolve) => setTimeout(resolve, timeout)),
]);
}
注意这个 timeout,它不是为了优雅,是为了防止某个清理函数把整个卸载流程拖死。优雅停机也得有强制边界。
取舍三:页面关闭时,别做重活
浏览器关闭页面时不会给你太多时间。beforeunload 在移动端不靠谱,我现在更愿意用 visibilitychange 和 pagehide。关闭时只做最小上报,复杂清理留到下次启动补偿。
这听起来不够优雅,但很实用。你不可能在用户关标签页的时候还等他断 WebSocket、清缓存、传日志。真那么做,用户只会觉得页面卡了一下。我的原则是:关闭瞬间做同步能做完的事,异步上报尽量小,剩下的交给下次启动的恢复逻辑。
取舍四:微前端卸载,别把子应用当进程
微前端里父应用经常假设子应用会乖乖执行 unmount,但子应用可能自己开了定时器、订阅了事件、连了 socket。我的做法是父应用给超时,子应用按约定清理,超时后父应用强制隔离。
这里有个很现实的取舍:协议定得太细,接入成本高;定得太粗,卸载不干净。我一般只要求子应用在 unmount 里做到三件事:停止新任务、断开长连接、清理全局监听。至于缓存和重活,不要求在卸载时做。
取舍五:SSR 服务停机,前端也要配合
如果 React 项目带 SSR,Node 那层收到 SIGTERM 后要先摘流量,再停止接收新请求,等在途请求结束,最后关连接池。等太久发布慢,等太短丢请求,通常按 P99 设一个超时,超时强杀。
前端这边也不能装没事,接口失败要有重试和降级页。优雅停机不是后端一个人的事,用户看到的是一整个链路。
最后
我现在不会追求“所有资源都优雅清理”,那不现实。更实际的做法是分级:长连接、定时器、全局事件必须管;读请求卸载就取消;写请求允许完成或补偿;页面关闭只做最小上报。项目小的时候先管前三样,微前端和 SSR 再上协议。
不出问题的话当然没问题,出一次问题你就知道这玩意儿值得。优雅停机的核心不是优雅,是知道哪些可以不等,哪些必须等,以及等不到的时候怎么收场。
评论
还没有评论。
发表评论
提交后评论将经过自动审核,审核通过后公开展示。