生命周期与错误处理
生命周期用于描述应用、视图和组件从创建到销毁的状态变化。本文介绍三层生命周期、组件副作用与资源清理,以及不同错误来源的处理边界。
管理资源时,先判断资源属于哪个层级、是否依赖首次渲染,以及隐藏或销毁时应该暂停还是彻底释放。
三层生命周期
每个 View 实例只挂载一次,但显示与隐藏可以发生多次;应用进入后台也不等于 View 已经销毁。因此,暂停工作和释放资源需要分开处理。
按资源归属选择生命周期
同一资源只选择一个主要所有者。例如,组件已经在 Effect 中创建并清理订阅时,不要再通过 useDestroy() 重复释放。需要跨显示周期复用的资源,应区分“隐藏时暂停”和“销毁时释放”。
上图包含两条事件轴:
useCreated、useMounted和useDestroy订阅 View 实例从创建、挂载到销毁的阶段;useShow/useHide订阅宿主可见性事件,可以往返多次;
应用的 foreground / background 是第三个维度,描述应用前后台或设备锁定状态变化,与 View 可见性相交但不等价。
注意
不要从图中推导
useMounted与首次useShow回调的严格先后关系。业务代码应分别按“首次渲染后”和“每次可见时”的语义组织任务。
App 生命周期
Framework 会把 App 生命周期中的同步异常规范化为 Error 后交给 onError。如果 onError 自身再次抛错,Framework 只记录错误,避免递归。
onAgentEvent(name, payload) 是运行在 App runtime 的应用级业务事件,不是生命周期。它可以重复触发,适合集中处理 Agent 驱动的跳转或刷新;回调同步抛错时同样进入 App onError。Page 函数组件使用 useAgentEvent(name, callback) 通过 getApp().eventChannel 订阅按业务事件名隔离的内部事件,组件清理时自动取消;Hook 回调错误同样交给 App onError。
View 生命周期 Hooks
useCreated()、useMounted()、useShow() 等 Hook 不是 React 组件自身的挂载或卸载生命周期。它们让函数组件订阅当前 Page / Widget 的 View 生命周期,因此多个组件可能收到同一次 View 事件。
这些 View 生命周期 Hooks 还有两项特殊行为:
- Framework 会记录 created 和 mounted 是否已经发生;组件晚注册
useCreated或useMounted时,会立即补触发一次; - Framework 会暂存
useError注册前发生的生命周期 Hook 错误,并在监听器注册后交付;
注意
该错误交付机制不是通用 React Error Boundary。
Effect 与资源清理
useEffect 用于让组件与请求、订阅、计时器等外部系统保持同步。依赖变化后,React 运行时会先执行上一次 cleanup,再执行新的 Effect;组件卸载时还会执行最后一次 cleanup。
useEffect、useMounted 和布局回调解决的问题不同:
注意
不要依赖“副作用在同一渲染调用栈中完成”的假设,也不要在组件函数中执行请求、订阅或写操作。
Framework 公开 useEffect,但没有公开 useLayoutEffect。需要布局结果时,使用对应组件公开的布局事件;不要用 useEffect 或 useMounted 推断布局和绘制时机。
例如,需要在容器尺寸变化后执行逻辑时,监听组件公开的布局事件:
线程职责和事件更新链路见视图渲染与交互。
错误处理
注意
图中的三条错误路径不能互相替代。业务异步错误需要显式捕获,生命周期错误处理器不是所有 Promise rejection 的全局接收器。
- App 生命周期回调抛错时,Framework 调用 App 的
onError; - 组件内注册的 View 生命周期 Hook 回调抛错时,Framework 规范化错误并交给
useError; - 业务异步请求、事件处理和 Promise 链应自行使用
try/catch或.catch(),不能假设它们一定进入生命周期错误链路;