一、核心命题
任何「由多个组件组成的系统」启动时,都会遇到同一个问题:
组件之间有依赖,不能随便先后启动;而且系统不仅要start,还要能优雅stop,甚至运行时换零件(热更新)。
这个问题的解法不是某个单一模式,而是一条由简到繁的演化路径。理解这条路径,比记住某个框架的 API 重要得多。
二、演化的四个层次
#mermaid-svg-96LzuOZwLL8iisIs{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;fill:#333;}@keyframes edge-animation-frame{from{stroke-dashoffset:0;}}@keyframes dash{to{stroke-dashoffset:0;}}#mermaid-svg-96LzuOZwLL8iisIs .edge-animation-slow{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 50s linear infinite;stroke-linecap:round;}#mermaid-svg-96LzuOZwLL8iisIs .edge-animation-fast{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 20s linear infinite;stroke-linecap:round;}#mermaid-svg-96LzuOZwLL8iisIs .error-icon{fill:#552222;}#mermaid-svg-96LzuOZwLL8iisIs .error-text{fill:#552222;stroke:#552222;}#mermaid-svg-96LzuOZwLL8iisIs .edge-thickness-normal{stroke-width:1px;}#mermaid-svg-96LzuOZwLL8iisIs .edge-thickness-thick{stroke-width:3.5px;}#mermaid-svg-96LzuOZwLL8iisIs .edge-pattern-solid{stroke-dasharray:0;}#mermaid-svg-96LzuOZwLL8iisIs .edge-thickness-invisible{stroke-width:0;fill:none;}#mermaid-svg-96LzuOZwLL8iisIs .edge-pattern-dashed{stroke-dasharray:3;}#mermaid-svg-96LzuOZwLL8iisIs .edge-pattern-dotted{stroke-dasharray:2;}#mermaid-svg-96LzuOZwLL8iisIs .marker{fill:#333333;stroke:#333333;}#mermaid-svg-96LzuOZwLL8iisIs .marker.cross{stroke:#333333;}#mermaid-svg-96LzuOZwLL8iisIs svg{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;}#mermaid-svg-96LzuOZwLL8iisIs p{margin:0;}#mermaid-svg-96LzuOZwLL8iisIs .label{font-family:"trebuchet ms",verdana,arial,sans-serif;color:#333;}#mermaid-svg-96LzuOZwLL8iisIs .cluster-label text{fill:#333;}#mermaid-svg-96LzuOZwLL8iisIs .cluster-label span{color:#333;}#mermaid-svg-96LzuOZwLL8iisIs .cluster-label span p{background-color:transparent;}#mermaid-svg-96LzuOZwLL8iisIs .label text,#mermaid-svg-96LzuOZwLL8iisIs span{fill:#333;color:#333;}#mermaid-svg-96LzuOZwLL8iisIs .node rect,#mermaid-svg-96LzuOZwLL8iisIs .node circle,#mermaid-svg-96LzuOZwLL8iisIs .node ellipse,#mermaid-svg-96LzuOZwLL8iisIs .node polygon,#mermaid-svg-96LzuOZwLL8iisIs .node path{fill:#ECECFF;stroke:#9370DB;stroke-width:1px;}#mermaid-svg-96LzuOZwLL8iisIs .rough-node .label text,#mermaid-svg-96LzuOZwLL8iisIs .node .label text,#mermaid-svg-96LzuOZwLL8iisIs .image-shape .label,#mermaid-svg-96LzuOZwLL8iisIs .icon-shape .label{text-anchor:middle;}#mermaid-svg-96LzuOZwLL8iisIs .node .katex path{fill:#000;stroke:#000;stroke-width:1px;}#mermaid-svg-96LzuOZwLL8iisIs .rough-node .label,#mermaid-svg-96LzuOZwLL8iisIs .node .label,#mermaid-svg-96LzuOZwLL8iisIs .image-shape .label,#mermaid-svg-96LzuOZwLL8iisIs .icon-shape .label{text-align:center;}#mermaid-svg-96LzuOZwLL8iisIs .node.clickable{cursor:pointer;}#mermaid-svg-96LzuOZwLL8iisIs .root .anchor path{fill:#333333!important;stroke-width:0;stroke:#333333;}#mermaid-svg-96LzuOZwLL8iisIs .arrowheadPath{fill:#333333;}#mermaid-svg-96LzuOZwLL8iisIs .edgePath .path{stroke:#333333;stroke-width:2.0px;}#mermaid-svg-96LzuOZwLL8iisIs .flowchart-link{stroke:#333333;fill:none;}#mermaid-svg-96LzuOZwLL8iisIs .edgeLabel{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-96LzuOZwLL8iisIs .edgeLabel p{background-color:rgba(232,232,232, 0.8);}#mermaid-svg-96LzuOZwLL8iisIs .edgeLabel rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-96LzuOZwLL8iisIs .labelBkg{background-color:rgba(232, 232, 232, 0.5);}#mermaid-svg-96LzuOZwLL8iisIs .cluster rect{fill:#ffffde;stroke:#aaaa33;stroke-width:1px;}#mermaid-svg-96LzuOZwLL8iisIs .cluster text{fill:#333;}#mermaid-svg-96LzuOZwLL8iisIs .cluster span{color:#333;}#mermaid-svg-96LzuOZwLL8iisIs div.mermaidTooltip{position:absolute;text-align:center;max-width:200px;padding:2px;font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:12px;background:hsl(80, 100%, 96.2745098039%);border:1px solid #aaaa33;border-radius:2px;pointer-events:none;z-index:100;}#mermaid-svg-96LzuOZwLL8iisIs .flowchartTitleText{text-anchor:middle;font-size:18px;fill:#333;}#mermaid-svg-96LzuOZwLL8iisIs rect.text{fill:none;stroke-width:0;}#mermaid-svg-96LzuOZwLL8iisIs .icon-shape,#mermaid-svg-96LzuOZwLL8iisIs .image-shape{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-96LzuOZwLL8iisIs .icon-shape p,#mermaid-svg-96LzuOZwLL8iisIs .image-shape p{background-color:rgba(232,232,232, 0.8);padding:2px;}#mermaid-svg-96LzuOZwLL8iisIs .icon-shape .label rect,#mermaid-svg-96LzuOZwLL8iisIs .image-shape .label rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-96LzuOZwLL8iisIs .label-icon{display:inline-block;height:1em;overflow:visible;vertical-align:-0.125em;}#mermaid-svg-96LzuOZwLL8iisIs .node .label-icon path{fill:currentColor;stroke:revert;stroke-width:revert;}#mermaid-svg-96LzuOZwLL8iisIs :root{--mermaid-font-family:"trebuchet ms",verdana,arial,sans-serif;} 层次 0
朴素初始化
init 完就 run
问题:组件有依赖,先 init 谁?
层次 1
两阶段初始化
先全部装配,再全部启动
问题:状态不可见、非法操作靠自觉、停不干净
层次 2
显式生命周期状态机
Lifecycle State Machine
问题:跨组件联动靠约定、样板代码重复、失败无法诊断
层次 3
模板方法 + 组合服务 + 事件通知
工业级完备形态
三个参照系的落点:INFINI Gateway 处于层次 1~2 之间,Hadoop 处于层次 3(标准版),ES 处于层次 3(精炼版)。
三、层次 0:朴素初始化
最直接的做法:在 main 里按顺序 init 一堆东西。
go
func main() {
db := initDB() // 先初始化数据库
cache := initCache() // 再初始化缓存
server := initServer(db, cache) // 最后初始化服务
server.Run()
}
问题 :组件变多、依赖变复杂后,「谁先谁后」变成写死在 main 里的脆弱知识。改一个组件,可能要动全局顺序。
初始化顺序脆弱性(Initialization Order Fiasco)------顺序的正确性散落在调用方,无法被组件自身保证。
四、层次 1:两阶段初始化
4.1 核心思想
把「准备」和「运行」拆成两个阶段,分两轮统一驱动:
第一轮:所有组件 Setup(装配/声明)------ 只读配置、建结构、注册,无副作用
第二轮:所有组件 Start(启动)------ 建连接、起 goroutine、监听端口
INFINI Gateway 的 module.Start():
go
for all { Setup() } // 先全部装配
for all { Start() } // 再全部启动
#mermaid-svg-vxnqcx1dnzGEC1Qq{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;fill:#333;}@keyframes edge-animation-frame{from{stroke-dashoffset:0;}}@keyframes dash{to{stroke-dashoffset:0;}}#mermaid-svg-vxnqcx1dnzGEC1Qq .edge-animation-slow{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 50s linear infinite;stroke-linecap:round;}#mermaid-svg-vxnqcx1dnzGEC1Qq .edge-animation-fast{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 20s linear infinite;stroke-linecap:round;}#mermaid-svg-vxnqcx1dnzGEC1Qq .error-icon{fill:#552222;}#mermaid-svg-vxnqcx1dnzGEC1Qq .error-text{fill:#552222;stroke:#552222;}#mermaid-svg-vxnqcx1dnzGEC1Qq .edge-thickness-normal{stroke-width:1px;}#mermaid-svg-vxnqcx1dnzGEC1Qq .edge-thickness-thick{stroke-width:3.5px;}#mermaid-svg-vxnqcx1dnzGEC1Qq .edge-pattern-solid{stroke-dasharray:0;}#mermaid-svg-vxnqcx1dnzGEC1Qq .edge-thickness-invisible{stroke-width:0;fill:none;}#mermaid-svg-vxnqcx1dnzGEC1Qq .edge-pattern-dashed{stroke-dasharray:3;}#mermaid-svg-vxnqcx1dnzGEC1Qq .edge-pattern-dotted{stroke-dasharray:2;}#mermaid-svg-vxnqcx1dnzGEC1Qq .marker{fill:#333333;stroke:#333333;}#mermaid-svg-vxnqcx1dnzGEC1Qq .marker.cross{stroke:#333333;}#mermaid-svg-vxnqcx1dnzGEC1Qq svg{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;}#mermaid-svg-vxnqcx1dnzGEC1Qq p{margin:0;}#mermaid-svg-vxnqcx1dnzGEC1Qq .label{font-family:"trebuchet ms",verdana,arial,sans-serif;color:#333;}#mermaid-svg-vxnqcx1dnzGEC1Qq .cluster-label text{fill:#333;}#mermaid-svg-vxnqcx1dnzGEC1Qq .cluster-label span{color:#333;}#mermaid-svg-vxnqcx1dnzGEC1Qq .cluster-label span p{background-color:transparent;}#mermaid-svg-vxnqcx1dnzGEC1Qq .label text,#mermaid-svg-vxnqcx1dnzGEC1Qq span{fill:#333;color:#333;}#mermaid-svg-vxnqcx1dnzGEC1Qq .node rect,#mermaid-svg-vxnqcx1dnzGEC1Qq .node circle,#mermaid-svg-vxnqcx1dnzGEC1Qq .node ellipse,#mermaid-svg-vxnqcx1dnzGEC1Qq .node polygon,#mermaid-svg-vxnqcx1dnzGEC1Qq .node path{fill:#ECECFF;stroke:#9370DB;stroke-width:1px;}#mermaid-svg-vxnqcx1dnzGEC1Qq .rough-node .label text,#mermaid-svg-vxnqcx1dnzGEC1Qq .node .label text,#mermaid-svg-vxnqcx1dnzGEC1Qq .image-shape .label,#mermaid-svg-vxnqcx1dnzGEC1Qq .icon-shape .label{text-anchor:middle;}#mermaid-svg-vxnqcx1dnzGEC1Qq .node .katex path{fill:#000;stroke:#000;stroke-width:1px;}#mermaid-svg-vxnqcx1dnzGEC1Qq .rough-node .label,#mermaid-svg-vxnqcx1dnzGEC1Qq .node .label,#mermaid-svg-vxnqcx1dnzGEC1Qq .image-shape .label,#mermaid-svg-vxnqcx1dnzGEC1Qq .icon-shape .label{text-align:center;}#mermaid-svg-vxnqcx1dnzGEC1Qq .node.clickable{cursor:pointer;}#mermaid-svg-vxnqcx1dnzGEC1Qq .root .anchor path{fill:#333333!important;stroke-width:0;stroke:#333333;}#mermaid-svg-vxnqcx1dnzGEC1Qq .arrowheadPath{fill:#333333;}#mermaid-svg-vxnqcx1dnzGEC1Qq .edgePath .path{stroke:#333333;stroke-width:2.0px;}#mermaid-svg-vxnqcx1dnzGEC1Qq .flowchart-link{stroke:#333333;fill:none;}#mermaid-svg-vxnqcx1dnzGEC1Qq .edgeLabel{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-vxnqcx1dnzGEC1Qq .edgeLabel p{background-color:rgba(232,232,232, 0.8);}#mermaid-svg-vxnqcx1dnzGEC1Qq .edgeLabel rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-vxnqcx1dnzGEC1Qq .labelBkg{background-color:rgba(232, 232, 232, 0.5);}#mermaid-svg-vxnqcx1dnzGEC1Qq .cluster rect{fill:#ffffde;stroke:#aaaa33;stroke-width:1px;}#mermaid-svg-vxnqcx1dnzGEC1Qq .cluster text{fill:#333;}#mermaid-svg-vxnqcx1dnzGEC1Qq .cluster span{color:#333;}#mermaid-svg-vxnqcx1dnzGEC1Qq div.mermaidTooltip{position:absolute;text-align:center;max-width:200px;padding:2px;font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:12px;background:hsl(80, 100%, 96.2745098039%);border:1px solid #aaaa33;border-radius:2px;pointer-events:none;z-index:100;}#mermaid-svg-vxnqcx1dnzGEC1Qq .flowchartTitleText{text-anchor:middle;font-size:18px;fill:#333;}#mermaid-svg-vxnqcx1dnzGEC1Qq rect.text{fill:none;stroke-width:0;}#mermaid-svg-vxnqcx1dnzGEC1Qq .icon-shape,#mermaid-svg-vxnqcx1dnzGEC1Qq .image-shape{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-vxnqcx1dnzGEC1Qq .icon-shape p,#mermaid-svg-vxnqcx1dnzGEC1Qq .image-shape p{background-color:rgba(232,232,232, 0.8);padding:2px;}#mermaid-svg-vxnqcx1dnzGEC1Qq .icon-shape .label rect,#mermaid-svg-vxnqcx1dnzGEC1Qq .image-shape .label rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-vxnqcx1dnzGEC1Qq .label-icon{display:inline-block;height:1em;overflow:visible;vertical-align:-0.125em;}#mermaid-svg-vxnqcx1dnzGEC1Qq .node .label-icon path{fill:currentColor;stroke:revert;stroke-width:revert;}#mermaid-svg-vxnqcx1dnzGEC1Qq :root{--mermaid-font-family:"trebuchet ms",verdana,arial,sans-serif;} 第二轮:Start
模块 A
模块 B
模块 C
第一轮:Setup
模块 A
模块 B
模块 C
任何模块 Start 时,
所有模块 Setup 都已完成
4.2 它解决的关键问题
「先全部装配,再全部启动」意味着:任何一个组件 Start 时,其他所有组件的 Setup 都已经完成。 依赖的「准备动作」被保证先于「运行动作」,顺序耦合被一举消除。
这就是 INFINI Gateway 里 GatewayModule(监听端口)能安全地 elastic.GetClient、common.GetRouter 的原因------这些依赖的 Setup 早已跑完,与注册顺序无关。
4.3 层次 1 的局限
- 状态不可见 :组件「有没有 Setup、有没有 Start」没有显式状态,要靠
actived、ormInited这种手写 bool 标志追踪。 - 非法操作靠自觉:重复 Start、Stop 后误 Start,没人拦。
- Stop 语义模糊 :
Stop()是「暂停可重启」还是「彻底销毁」?gateway 没区分。 - 中间态可用性陷阱:Setup 完、Start 前的对象「存在但不可用」,容易被误调。
层次 1 解决了「顺序 」问题,但把「状态」问题留给了开发者自己兜。
五、层次 2:显式生命周期状态机
5.1 核心思想
给每个组件一个显式的、可校验的状态机,把「能不能做某个操作」从「约定」变成「框架强制」。
Hadoop 的 Service 定义了四态:
#mermaid-svg-y4gM3zfa292xGalI{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;fill:#333;}@keyframes edge-animation-frame{from{stroke-dashoffset:0;}}@keyframes dash{to{stroke-dashoffset:0;}}#mermaid-svg-y4gM3zfa292xGalI .edge-animation-slow{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 50s linear infinite;stroke-linecap:round;}#mermaid-svg-y4gM3zfa292xGalI .edge-animation-fast{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 20s linear infinite;stroke-linecap:round;}#mermaid-svg-y4gM3zfa292xGalI .error-icon{fill:#552222;}#mermaid-svg-y4gM3zfa292xGalI .error-text{fill:#552222;stroke:#552222;}#mermaid-svg-y4gM3zfa292xGalI .edge-thickness-normal{stroke-width:1px;}#mermaid-svg-y4gM3zfa292xGalI .edge-thickness-thick{stroke-width:3.5px;}#mermaid-svg-y4gM3zfa292xGalI .edge-pattern-solid{stroke-dasharray:0;}#mermaid-svg-y4gM3zfa292xGalI .edge-thickness-invisible{stroke-width:0;fill:none;}#mermaid-svg-y4gM3zfa292xGalI .edge-pattern-dashed{stroke-dasharray:3;}#mermaid-svg-y4gM3zfa292xGalI .edge-pattern-dotted{stroke-dasharray:2;}#mermaid-svg-y4gM3zfa292xGalI .marker{fill:#333333;stroke:#333333;}#mermaid-svg-y4gM3zfa292xGalI .marker.cross{stroke:#333333;}#mermaid-svg-y4gM3zfa292xGalI svg{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;}#mermaid-svg-y4gM3zfa292xGalI p{margin:0;}#mermaid-svg-y4gM3zfa292xGalI defs #statediagram-barbEnd{fill:#333333;stroke:#333333;}#mermaid-svg-y4gM3zfa292xGalI g.stateGroup text{fill:#9370DB;stroke:none;font-size:10px;}#mermaid-svg-y4gM3zfa292xGalI g.stateGroup text{fill:#333;stroke:none;font-size:10px;}#mermaid-svg-y4gM3zfa292xGalI g.stateGroup .state-title{font-weight:bolder;fill:#131300;}#mermaid-svg-y4gM3zfa292xGalI g.stateGroup rect{fill:#ECECFF;stroke:#9370DB;}#mermaid-svg-y4gM3zfa292xGalI g.stateGroup line{stroke:#333333;stroke-width:1;}#mermaid-svg-y4gM3zfa292xGalI .transition{stroke:#333333;stroke-width:1;fill:none;}#mermaid-svg-y4gM3zfa292xGalI .stateGroup .composit{fill:white;border-bottom:1px;}#mermaid-svg-y4gM3zfa292xGalI .stateGroup .alt-composit{fill:#e0e0e0;border-bottom:1px;}#mermaid-svg-y4gM3zfa292xGalI .state-note{stroke:#aaaa33;fill:#fff5ad;}#mermaid-svg-y4gM3zfa292xGalI .state-note text{fill:black;stroke:none;font-size:10px;}#mermaid-svg-y4gM3zfa292xGalI .stateLabel .box{stroke:none;stroke-width:0;fill:#ECECFF;opacity:0.5;}#mermaid-svg-y4gM3zfa292xGalI .edgeLabel .label rect{fill:#ECECFF;opacity:0.5;}#mermaid-svg-y4gM3zfa292xGalI .edgeLabel{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-y4gM3zfa292xGalI .edgeLabel p{background-color:rgba(232,232,232, 0.8);}#mermaid-svg-y4gM3zfa292xGalI .edgeLabel rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-y4gM3zfa292xGalI .edgeLabel .label text{fill:#333;}#mermaid-svg-y4gM3zfa292xGalI .label div .edgeLabel{color:#333;}#mermaid-svg-y4gM3zfa292xGalI .stateLabel text{fill:#131300;font-size:10px;font-weight:bold;}#mermaid-svg-y4gM3zfa292xGalI .node circle.state-start{fill:#333333;stroke:#333333;}#mermaid-svg-y4gM3zfa292xGalI .node .fork-join{fill:#333333;stroke:#333333;}#mermaid-svg-y4gM3zfa292xGalI .node circle.state-end{fill:#9370DB;stroke:white;stroke-width:1.5;}#mermaid-svg-y4gM3zfa292xGalI .end-state-inner{fill:white;stroke-width:1.5;}#mermaid-svg-y4gM3zfa292xGalI .node rect{fill:#ECECFF;stroke:#9370DB;stroke-width:1px;}#mermaid-svg-y4gM3zfa292xGalI .node polygon{fill:#ECECFF;stroke:#9370DB;stroke-width:1px;}#mermaid-svg-y4gM3zfa292xGalI #statediagram-barbEnd{fill:#333333;}#mermaid-svg-y4gM3zfa292xGalI .statediagram-cluster rect{fill:#ECECFF;stroke:#9370DB;stroke-width:1px;}#mermaid-svg-y4gM3zfa292xGalI .cluster-label,#mermaid-svg-y4gM3zfa292xGalI .nodeLabel{color:#131300;}#mermaid-svg-y4gM3zfa292xGalI .statediagram-cluster rect.outer{rx:5px;ry:5px;}#mermaid-svg-y4gM3zfa292xGalI .statediagram-state .divider{stroke:#9370DB;}#mermaid-svg-y4gM3zfa292xGalI .statediagram-state .title-state{rx:5px;ry:5px;}#mermaid-svg-y4gM3zfa292xGalI .statediagram-cluster.statediagram-cluster .inner{fill:white;}#mermaid-svg-y4gM3zfa292xGalI .statediagram-cluster.statediagram-cluster-alt .inner{fill:#f0f0f0;}#mermaid-svg-y4gM3zfa292xGalI .statediagram-cluster .inner{rx:0;ry:0;}#mermaid-svg-y4gM3zfa292xGalI .statediagram-state rect.basic{rx:5px;ry:5px;}#mermaid-svg-y4gM3zfa292xGalI .statediagram-state rect.divider{stroke-dasharray:10,10;fill:#f0f0f0;}#mermaid-svg-y4gM3zfa292xGalI .note-edge{stroke-dasharray:5;}#mermaid-svg-y4gM3zfa292xGalI .statediagram-note rect{fill:#fff5ad;stroke:#aaaa33;stroke-width:1px;rx:0;ry:0;}#mermaid-svg-y4gM3zfa292xGalI .statediagram-note rect{fill:#fff5ad;stroke:#aaaa33;stroke-width:1px;rx:0;ry:0;}#mermaid-svg-y4gM3zfa292xGalI .statediagram-note text{fill:black;}#mermaid-svg-y4gM3zfa292xGalI .statediagram-note .nodeLabel{color:black;}#mermaid-svg-y4gM3zfa292xGalI .statediagram .edgeLabel{color:red;}#mermaid-svg-y4gM3zfa292xGalI #dependencyStart,#mermaid-svg-y4gM3zfa292xGalI #dependencyEnd{fill:#333333;stroke:#333333;stroke-width:1;}#mermaid-svg-y4gM3zfa292xGalI .statediagramTitleText{text-anchor:middle;font-size:18px;fill:#333;}#mermaid-svg-y4gM3zfa292xGalI :root{--mermaid-font-family:"trebuchet ms",verdana,arial,sans-serif;} init()
stop()
start()
stop()
stop()
NOTINITED
INITED
STOPPED
STARTED
ES 的 Lifecycle 也是四态,但多一个 CLOSED(stop 后可再 start,close 不可逆):
#mermaid-svg-IwCfGdN2LLKBhiYk{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;fill:#333;}@keyframes edge-animation-frame{from{stroke-dashoffset:0;}}@keyframes dash{to{stroke-dashoffset:0;}}#mermaid-svg-IwCfGdN2LLKBhiYk .edge-animation-slow{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 50s linear infinite;stroke-linecap:round;}#mermaid-svg-IwCfGdN2LLKBhiYk .edge-animation-fast{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 20s linear infinite;stroke-linecap:round;}#mermaid-svg-IwCfGdN2LLKBhiYk .error-icon{fill:#552222;}#mermaid-svg-IwCfGdN2LLKBhiYk .error-text{fill:#552222;stroke:#552222;}#mermaid-svg-IwCfGdN2LLKBhiYk .edge-thickness-normal{stroke-width:1px;}#mermaid-svg-IwCfGdN2LLKBhiYk .edge-thickness-thick{stroke-width:3.5px;}#mermaid-svg-IwCfGdN2LLKBhiYk .edge-pattern-solid{stroke-dasharray:0;}#mermaid-svg-IwCfGdN2LLKBhiYk .edge-thickness-invisible{stroke-width:0;fill:none;}#mermaid-svg-IwCfGdN2LLKBhiYk .edge-pattern-dashed{stroke-dasharray:3;}#mermaid-svg-IwCfGdN2LLKBhiYk .edge-pattern-dotted{stroke-dasharray:2;}#mermaid-svg-IwCfGdN2LLKBhiYk .marker{fill:#333333;stroke:#333333;}#mermaid-svg-IwCfGdN2LLKBhiYk .marker.cross{stroke:#333333;}#mermaid-svg-IwCfGdN2LLKBhiYk svg{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;}#mermaid-svg-IwCfGdN2LLKBhiYk p{margin:0;}#mermaid-svg-IwCfGdN2LLKBhiYk defs #statediagram-barbEnd{fill:#333333;stroke:#333333;}#mermaid-svg-IwCfGdN2LLKBhiYk g.stateGroup text{fill:#9370DB;stroke:none;font-size:10px;}#mermaid-svg-IwCfGdN2LLKBhiYk g.stateGroup text{fill:#333;stroke:none;font-size:10px;}#mermaid-svg-IwCfGdN2LLKBhiYk g.stateGroup .state-title{font-weight:bolder;fill:#131300;}#mermaid-svg-IwCfGdN2LLKBhiYk g.stateGroup rect{fill:#ECECFF;stroke:#9370DB;}#mermaid-svg-IwCfGdN2LLKBhiYk g.stateGroup line{stroke:#333333;stroke-width:1;}#mermaid-svg-IwCfGdN2LLKBhiYk .transition{stroke:#333333;stroke-width:1;fill:none;}#mermaid-svg-IwCfGdN2LLKBhiYk .stateGroup .composit{fill:white;border-bottom:1px;}#mermaid-svg-IwCfGdN2LLKBhiYk .stateGroup .alt-composit{fill:#e0e0e0;border-bottom:1px;}#mermaid-svg-IwCfGdN2LLKBhiYk .state-note{stroke:#aaaa33;fill:#fff5ad;}#mermaid-svg-IwCfGdN2LLKBhiYk .state-note text{fill:black;stroke:none;font-size:10px;}#mermaid-svg-IwCfGdN2LLKBhiYk .stateLabel .box{stroke:none;stroke-width:0;fill:#ECECFF;opacity:0.5;}#mermaid-svg-IwCfGdN2LLKBhiYk .edgeLabel .label rect{fill:#ECECFF;opacity:0.5;}#mermaid-svg-IwCfGdN2LLKBhiYk .edgeLabel{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-IwCfGdN2LLKBhiYk .edgeLabel p{background-color:rgba(232,232,232, 0.8);}#mermaid-svg-IwCfGdN2LLKBhiYk .edgeLabel rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-IwCfGdN2LLKBhiYk .edgeLabel .label text{fill:#333;}#mermaid-svg-IwCfGdN2LLKBhiYk .label div .edgeLabel{color:#333;}#mermaid-svg-IwCfGdN2LLKBhiYk .stateLabel text{fill:#131300;font-size:10px;font-weight:bold;}#mermaid-svg-IwCfGdN2LLKBhiYk .node circle.state-start{fill:#333333;stroke:#333333;}#mermaid-svg-IwCfGdN2LLKBhiYk .node .fork-join{fill:#333333;stroke:#333333;}#mermaid-svg-IwCfGdN2LLKBhiYk .node circle.state-end{fill:#9370DB;stroke:white;stroke-width:1.5;}#mermaid-svg-IwCfGdN2LLKBhiYk .end-state-inner{fill:white;stroke-width:1.5;}#mermaid-svg-IwCfGdN2LLKBhiYk .node rect{fill:#ECECFF;stroke:#9370DB;stroke-width:1px;}#mermaid-svg-IwCfGdN2LLKBhiYk .node polygon{fill:#ECECFF;stroke:#9370DB;stroke-width:1px;}#mermaid-svg-IwCfGdN2LLKBhiYk #statediagram-barbEnd{fill:#333333;}#mermaid-svg-IwCfGdN2LLKBhiYk .statediagram-cluster rect{fill:#ECECFF;stroke:#9370DB;stroke-width:1px;}#mermaid-svg-IwCfGdN2LLKBhiYk .cluster-label,#mermaid-svg-IwCfGdN2LLKBhiYk .nodeLabel{color:#131300;}#mermaid-svg-IwCfGdN2LLKBhiYk .statediagram-cluster rect.outer{rx:5px;ry:5px;}#mermaid-svg-IwCfGdN2LLKBhiYk .statediagram-state .divider{stroke:#9370DB;}#mermaid-svg-IwCfGdN2LLKBhiYk .statediagram-state .title-state{rx:5px;ry:5px;}#mermaid-svg-IwCfGdN2LLKBhiYk .statediagram-cluster.statediagram-cluster .inner{fill:white;}#mermaid-svg-IwCfGdN2LLKBhiYk .statediagram-cluster.statediagram-cluster-alt .inner{fill:#f0f0f0;}#mermaid-svg-IwCfGdN2LLKBhiYk .statediagram-cluster .inner{rx:0;ry:0;}#mermaid-svg-IwCfGdN2LLKBhiYk .statediagram-state rect.basic{rx:5px;ry:5px;}#mermaid-svg-IwCfGdN2LLKBhiYk .statediagram-state rect.divider{stroke-dasharray:10,10;fill:#f0f0f0;}#mermaid-svg-IwCfGdN2LLKBhiYk .note-edge{stroke-dasharray:5;}#mermaid-svg-IwCfGdN2LLKBhiYk .statediagram-note rect{fill:#fff5ad;stroke:#aaaa33;stroke-width:1px;rx:0;ry:0;}#mermaid-svg-IwCfGdN2LLKBhiYk .statediagram-note rect{fill:#fff5ad;stroke:#aaaa33;stroke-width:1px;rx:0;ry:0;}#mermaid-svg-IwCfGdN2LLKBhiYk .statediagram-note text{fill:black;}#mermaid-svg-IwCfGdN2LLKBhiYk .statediagram-note .nodeLabel{color:black;}#mermaid-svg-IwCfGdN2LLKBhiYk .statediagram .edgeLabel{color:red;}#mermaid-svg-IwCfGdN2LLKBhiYk #dependencyStart,#mermaid-svg-IwCfGdN2LLKBhiYk #dependencyEnd{fill:#333333;stroke:#333333;stroke-width:1;}#mermaid-svg-IwCfGdN2LLKBhiYk .statediagramTitleText{text-anchor:middle;font-size:18px;fill:#333;}#mermaid-svg-IwCfGdN2LLKBhiYk :root{--mermaid-font-family:"trebuchet ms",verdana,arial,sans-serif;} start()
stop()
close()
stop()
start()
close()
INITIALIZED
STARTED
STOPPED
CLOSED
对比 INFINI Gateway 的「伪状态机」------只有散落的 bool 标志,没有显式状态和转移约束:
#mermaid-svg-5IJrFIOmg4gsVDKE{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;fill:#333;}@keyframes edge-animation-frame{from{stroke-dashoffset:0;}}@keyframes dash{to{stroke-dashoffset:0;}}#mermaid-svg-5IJrFIOmg4gsVDKE .edge-animation-slow{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 50s linear infinite;stroke-linecap:round;}#mermaid-svg-5IJrFIOmg4gsVDKE .edge-animation-fast{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 20s linear infinite;stroke-linecap:round;}#mermaid-svg-5IJrFIOmg4gsVDKE .error-icon{fill:#552222;}#mermaid-svg-5IJrFIOmg4gsVDKE .error-text{fill:#552222;stroke:#552222;}#mermaid-svg-5IJrFIOmg4gsVDKE .edge-thickness-normal{stroke-width:1px;}#mermaid-svg-5IJrFIOmg4gsVDKE .edge-thickness-thick{stroke-width:3.5px;}#mermaid-svg-5IJrFIOmg4gsVDKE .edge-pattern-solid{stroke-dasharray:0;}#mermaid-svg-5IJrFIOmg4gsVDKE .edge-thickness-invisible{stroke-width:0;fill:none;}#mermaid-svg-5IJrFIOmg4gsVDKE .edge-pattern-dashed{stroke-dasharray:3;}#mermaid-svg-5IJrFIOmg4gsVDKE .edge-pattern-dotted{stroke-dasharray:2;}#mermaid-svg-5IJrFIOmg4gsVDKE .marker{fill:#333333;stroke:#333333;}#mermaid-svg-5IJrFIOmg4gsVDKE .marker.cross{stroke:#333333;}#mermaid-svg-5IJrFIOmg4gsVDKE svg{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;}#mermaid-svg-5IJrFIOmg4gsVDKE p{margin:0;}#mermaid-svg-5IJrFIOmg4gsVDKE .label{font-family:"trebuchet ms",verdana,arial,sans-serif;color:#333;}#mermaid-svg-5IJrFIOmg4gsVDKE .cluster-label text{fill:#333;}#mermaid-svg-5IJrFIOmg4gsVDKE .cluster-label span{color:#333;}#mermaid-svg-5IJrFIOmg4gsVDKE .cluster-label span p{background-color:transparent;}#mermaid-svg-5IJrFIOmg4gsVDKE .label text,#mermaid-svg-5IJrFIOmg4gsVDKE span{fill:#333;color:#333;}#mermaid-svg-5IJrFIOmg4gsVDKE .node rect,#mermaid-svg-5IJrFIOmg4gsVDKE .node circle,#mermaid-svg-5IJrFIOmg4gsVDKE .node ellipse,#mermaid-svg-5IJrFIOmg4gsVDKE .node polygon,#mermaid-svg-5IJrFIOmg4gsVDKE .node path{fill:#ECECFF;stroke:#9370DB;stroke-width:1px;}#mermaid-svg-5IJrFIOmg4gsVDKE .rough-node .label text,#mermaid-svg-5IJrFIOmg4gsVDKE .node .label text,#mermaid-svg-5IJrFIOmg4gsVDKE .image-shape .label,#mermaid-svg-5IJrFIOmg4gsVDKE .icon-shape .label{text-anchor:middle;}#mermaid-svg-5IJrFIOmg4gsVDKE .node .katex path{fill:#000;stroke:#000;stroke-width:1px;}#mermaid-svg-5IJrFIOmg4gsVDKE .rough-node .label,#mermaid-svg-5IJrFIOmg4gsVDKE .node .label,#mermaid-svg-5IJrFIOmg4gsVDKE .image-shape .label,#mermaid-svg-5IJrFIOmg4gsVDKE .icon-shape .label{text-align:center;}#mermaid-svg-5IJrFIOmg4gsVDKE .node.clickable{cursor:pointer;}#mermaid-svg-5IJrFIOmg4gsVDKE .root .anchor path{fill:#333333!important;stroke-width:0;stroke:#333333;}#mermaid-svg-5IJrFIOmg4gsVDKE .arrowheadPath{fill:#333333;}#mermaid-svg-5IJrFIOmg4gsVDKE .edgePath .path{stroke:#333333;stroke-width:2.0px;}#mermaid-svg-5IJrFIOmg4gsVDKE .flowchart-link{stroke:#333333;fill:none;}#mermaid-svg-5IJrFIOmg4gsVDKE .edgeLabel{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-5IJrFIOmg4gsVDKE .edgeLabel p{background-color:rgba(232,232,232, 0.8);}#mermaid-svg-5IJrFIOmg4gsVDKE .edgeLabel rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-5IJrFIOmg4gsVDKE .labelBkg{background-color:rgba(232, 232, 232, 0.5);}#mermaid-svg-5IJrFIOmg4gsVDKE .cluster rect{fill:#ffffde;stroke:#aaaa33;stroke-width:1px;}#mermaid-svg-5IJrFIOmg4gsVDKE .cluster text{fill:#333;}#mermaid-svg-5IJrFIOmg4gsVDKE .cluster span{color:#333;}#mermaid-svg-5IJrFIOmg4gsVDKE div.mermaidTooltip{position:absolute;text-align:center;max-width:200px;padding:2px;font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:12px;background:hsl(80, 100%, 96.2745098039%);border:1px solid #aaaa33;border-radius:2px;pointer-events:none;z-index:100;}#mermaid-svg-5IJrFIOmg4gsVDKE .flowchartTitleText{text-anchor:middle;font-size:18px;fill:#333;}#mermaid-svg-5IJrFIOmg4gsVDKE rect.text{fill:none;stroke-width:0;}#mermaid-svg-5IJrFIOmg4gsVDKE .icon-shape,#mermaid-svg-5IJrFIOmg4gsVDKE .image-shape{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-5IJrFIOmg4gsVDKE .icon-shape p,#mermaid-svg-5IJrFIOmg4gsVDKE .image-shape p{background-color:rgba(232,232,232, 0.8);padding:2px;}#mermaid-svg-5IJrFIOmg4gsVDKE .icon-shape .label rect,#mermaid-svg-5IJrFIOmg4gsVDKE .image-shape .label rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-5IJrFIOmg4gsVDKE .label-icon{display:inline-block;height:1em;overflow:visible;vertical-align:-0.125em;}#mermaid-svg-5IJrFIOmg4gsVDKE .node .label-icon path{fill:currentColor;stroke:revert;stroke-width:revert;}#mermaid-svg-5IJrFIOmg4gsVDKE :root{--mermaid-font-family:"trebuchet ms",verdana,arial,sans-serif;} Hadoop / ES:显式状态机
NOTINITED
INITED
STARTED
STOPPED
gateway:手写 bool 标志
actived
ormInited
statsdInited
5.2 关键设计决策一:状态转移「可校验 + 幂等」
每个转移都要先判断「合法吗」,再执行。Hadoop 用二维布尔矩阵 做转移表(ServiceStateModel):
java
private static final boolean[][] statemap = {
// uninited inited started stopped
/* uninited */ { false, true, false, true },
/* inited */ { false, true, true, true },
/* started */ { false, false, true, true },
/* stopped */ { false, false, false, true },
};
public static boolean isValidStateTransition(STATE current, STATE proposed) {
return statemap[current.getValue()][proposed.getValue()]; // O(1) 查表
}
ES 则用 switch + canMoveToXxx 方法。两者语义等价、实现不同:
| Hadoop | ES | |
|---|---|---|
| 转移表 | 二维布尔矩阵(数据驱动) | switch 分支(代码驱动) |
| 加状态成本 | 改矩阵一行 | 加 case + 加方法 |
两个框架都由此获得了三个层次 1 没有的性质:
- 幂等:重复调用同一转移返回「已在目标态」,而非报错 → 调用方可安全重试。
- 非法操作显式报错 :
STOPPED/CLOSED后再start直接抛异常 → 杜绝误用。 - 线程安全 :
volatile+synchronized→ 并发下状态一致。
5.3 关键设计决策二:失败自动回退(Hadoop 的独有约束)
Hadoop 的接口契约(Service 的 Javadoc)明确要求:init/start 失败时,「MUST enter STOPPED」,不允许停在中间态。
落地在 AbstractService.init():
java
try {
serviceInit(config);
} catch (Exception e) {
noteFailure(e); // 记录失败原因 + 失败状态
ServiceOperations.stopQuietly(LOG, this); // 失败自动 stop 到终态
throw ServiceStateException.convert(e);
}
这杜绝了「半初始化」的中间态残留------组件要么完整就绪,要么干净地停在 STOPPED,不会「似好非好」。
5.4 它解决的问题
把「状态」从散落的 bool 标志 收敛为一个受控的状态机 ,并附加了「失败可诊断」(Hadoop 的 noteFailure/getLifecycleHistory/getBlockers)和「失败可回退」两个层次 1 没有的能力。
六、层次 3:模板方法 + 组合服务 + 事件通知(工业级完备形态)
6.1 模板方法:把通用逻辑固化,消灭样板代码
如果每个组件都要自己写「校验状态 → 通知 → 做事 → 转移状态」,就是重复劳动。Hadoop 和 ES 都用模板方法模式解决:
java
// Hadoop AbstractService:基类固化通用流程,子类只写 serviceXxx
public void init(Configuration conf) {
if (isInState(INITED)) return; // 通用:幂等校验
synchronized (stateChangeLock) {
enterState(INITED); // 通用:转移
try {
serviceInit(conf); // 变化:子类实现
notifyListeners(); // 通用:通知
} catch (Exception e) {
noteFailure(e); // 通用:失败处理
ServiceOperations.stopQuietly(...);
}
}
}
protected void serviceInit(Configuration conf) {} // 子类覆写点
protected void serviceStart() {}
protected void serviceStop() {}
设计精髓 :基类负责「状态、校验、通知、失败处理」这些不变的通用流程 ,子类只负责 serviceInit/serviceStart/serviceStop 三个变化的业务动作。
对照:INFINI Gateway 每个模块要自己写 bool 判断;Hadoop/ES 的子类完全不用关心状态------这是「框架约束」替代「约定自觉」的体现。
6.2 组合服务:多组件编排的模板化(Hadoop 的 CompositeService)
单组件用模板方法解决后,下一个问题是「一堆组件怎么统一编排 」。Hadoop 的 CompositeService 给出答案------编排本身也是模板方法:
java
public class CompositeService extends AbstractService {
private final List<Service> serviceList = new ArrayList<>();
protected void serviceInit(Configuration conf) {
for (Service s : getServices()) s.init(conf); // 顺序 init
super.serviceInit(conf);
}
protected void serviceStart() {
for (Service s : getServices()) s.start(); // 顺序 start
super.serviceStart();
}
protected void serviceStop() {
// stop in reverse order of start
for (int i = num - 1; i >= 0; i--) { // ★ 逆序 stop
ServiceOperations.stopQuietly(LOG, s); // 容错:收集首异常但停完
}
super.serviceStop();
}
}
真实实证 (NodeManager,hadoop-yarn-server-nodemanager/NodeManager.java):
java
protected void serviceInit(Configuration conf) {
addService(del); // :415 删除服务
addService(nodeHealthChecker); // :421 健康检查
addService(containerManager); // :448 容器管理
addService(webServer); // :459 Web 服务
// ...
// ★ StatusUpdater should be added last so that it get
// started last so that we make sure everything is up before registering.
addService(nodeStatusUpdater); // :487 StatusUpdater必须最后 add → 最后 start
super.serviceInit(conf); // :501
}
关键 :Hadoop 的 CompositeService 用「addService 的顺序 」来表达「依赖顺序」------不需要显式的 priority 字段,顺序本身就是依赖的载体。这比 INFINI Gateway 的「优先级数字」更隐式、更简洁,但也更依赖开发者「按依赖顺序 add」的自觉。
「顺序 init/start + 逆序 stop」的编排示意:
#mermaid-svg-JJEs16JyZRmDK0bl{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;fill:#333;}@keyframes edge-animation-frame{from{stroke-dashoffset:0;}}@keyframes dash{to{stroke-dashoffset:0;}}#mermaid-svg-JJEs16JyZRmDK0bl .edge-animation-slow{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 50s linear infinite;stroke-linecap:round;}#mermaid-svg-JJEs16JyZRmDK0bl .edge-animation-fast{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 20s linear infinite;stroke-linecap:round;}#mermaid-svg-JJEs16JyZRmDK0bl .error-icon{fill:#552222;}#mermaid-svg-JJEs16JyZRmDK0bl .error-text{fill:#552222;stroke:#552222;}#mermaid-svg-JJEs16JyZRmDK0bl .edge-thickness-normal{stroke-width:1px;}#mermaid-svg-JJEs16JyZRmDK0bl .edge-thickness-thick{stroke-width:3.5px;}#mermaid-svg-JJEs16JyZRmDK0bl .edge-pattern-solid{stroke-dasharray:0;}#mermaid-svg-JJEs16JyZRmDK0bl .edge-thickness-invisible{stroke-width:0;fill:none;}#mermaid-svg-JJEs16JyZRmDK0bl .edge-pattern-dashed{stroke-dasharray:3;}#mermaid-svg-JJEs16JyZRmDK0bl .edge-pattern-dotted{stroke-dasharray:2;}#mermaid-svg-JJEs16JyZRmDK0bl .marker{fill:#333333;stroke:#333333;}#mermaid-svg-JJEs16JyZRmDK0bl .marker.cross{stroke:#333333;}#mermaid-svg-JJEs16JyZRmDK0bl svg{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;}#mermaid-svg-JJEs16JyZRmDK0bl p{margin:0;}#mermaid-svg-JJEs16JyZRmDK0bl .label{font-family:"trebuchet ms",verdana,arial,sans-serif;color:#333;}#mermaid-svg-JJEs16JyZRmDK0bl .cluster-label text{fill:#333;}#mermaid-svg-JJEs16JyZRmDK0bl .cluster-label span{color:#333;}#mermaid-svg-JJEs16JyZRmDK0bl .cluster-label span p{background-color:transparent;}#mermaid-svg-JJEs16JyZRmDK0bl .label text,#mermaid-svg-JJEs16JyZRmDK0bl span{fill:#333;color:#333;}#mermaid-svg-JJEs16JyZRmDK0bl .node rect,#mermaid-svg-JJEs16JyZRmDK0bl .node circle,#mermaid-svg-JJEs16JyZRmDK0bl .node ellipse,#mermaid-svg-JJEs16JyZRmDK0bl .node polygon,#mermaid-svg-JJEs16JyZRmDK0bl .node path{fill:#ECECFF;stroke:#9370DB;stroke-width:1px;}#mermaid-svg-JJEs16JyZRmDK0bl .rough-node .label text,#mermaid-svg-JJEs16JyZRmDK0bl .node .label text,#mermaid-svg-JJEs16JyZRmDK0bl .image-shape .label,#mermaid-svg-JJEs16JyZRmDK0bl .icon-shape .label{text-anchor:middle;}#mermaid-svg-JJEs16JyZRmDK0bl .node .katex path{fill:#000;stroke:#000;stroke-width:1px;}#mermaid-svg-JJEs16JyZRmDK0bl .rough-node .label,#mermaid-svg-JJEs16JyZRmDK0bl .node .label,#mermaid-svg-JJEs16JyZRmDK0bl .image-shape .label,#mermaid-svg-JJEs16JyZRmDK0bl .icon-shape .label{text-align:center;}#mermaid-svg-JJEs16JyZRmDK0bl .node.clickable{cursor:pointer;}#mermaid-svg-JJEs16JyZRmDK0bl .root .anchor path{fill:#333333!important;stroke-width:0;stroke:#333333;}#mermaid-svg-JJEs16JyZRmDK0bl .arrowheadPath{fill:#333333;}#mermaid-svg-JJEs16JyZRmDK0bl .edgePath .path{stroke:#333333;stroke-width:2.0px;}#mermaid-svg-JJEs16JyZRmDK0bl .flowchart-link{stroke:#333333;fill:none;}#mermaid-svg-JJEs16JyZRmDK0bl .edgeLabel{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-JJEs16JyZRmDK0bl .edgeLabel p{background-color:rgba(232,232,232, 0.8);}#mermaid-svg-JJEs16JyZRmDK0bl .edgeLabel rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-JJEs16JyZRmDK0bl .labelBkg{background-color:rgba(232, 232, 232, 0.5);}#mermaid-svg-JJEs16JyZRmDK0bl .cluster rect{fill:#ffffde;stroke:#aaaa33;stroke-width:1px;}#mermaid-svg-JJEs16JyZRmDK0bl .cluster text{fill:#333;}#mermaid-svg-JJEs16JyZRmDK0bl .cluster span{color:#333;}#mermaid-svg-JJEs16JyZRmDK0bl div.mermaidTooltip{position:absolute;text-align:center;max-width:200px;padding:2px;font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:12px;background:hsl(80, 100%, 96.2745098039%);border:1px solid #aaaa33;border-radius:2px;pointer-events:none;z-index:100;}#mermaid-svg-JJEs16JyZRmDK0bl .flowchartTitleText{text-anchor:middle;font-size:18px;fill:#333;}#mermaid-svg-JJEs16JyZRmDK0bl rect.text{fill:none;stroke-width:0;}#mermaid-svg-JJEs16JyZRmDK0bl .icon-shape,#mermaid-svg-JJEs16JyZRmDK0bl .image-shape{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-JJEs16JyZRmDK0bl .icon-shape p,#mermaid-svg-JJEs16JyZRmDK0bl .image-shape p{background-color:rgba(232,232,232, 0.8);padding:2px;}#mermaid-svg-JJEs16JyZRmDK0bl .icon-shape .label rect,#mermaid-svg-JJEs16JyZRmDK0bl .image-shape .label rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-JJEs16JyZRmDK0bl .label-icon{display:inline-block;height:1em;overflow:visible;vertical-align:-0.125em;}#mermaid-svg-JJEs16JyZRmDK0bl .node .label-icon path{fill:currentColor;stroke:revert;stroke-width:revert;}#mermaid-svg-JJEs16JyZRmDK0bl :root{--mermaid-font-family:"trebuchet ms",verdana,arial,sans-serif;} stop 镜像对称
反向:逆序 stop(后 add 的先停)
nodeStatusUpdater
webServer
containerManager
nodeHealthChecker
del 删除服务
正向:顺序 start(addService 顺序)
del 删除服务
nodeHealthChecker
containerManager
webServer
nodeStatusUpdater
6.3 事件通知:把跨组件联动显式化
层次 1~2 的跨组件联动靠「逆序 stop」这种隐式约定。两个框架都引入了显式监听:
- Hadoop
ServiceStateChangeListener:一个stateChanged(Service service)回调。 - ES
LifecycleListener:6 个钩子beforeStart/afterStart/beforeStop/afterStop/beforeClose/afterClose。
这让「A 状态变化时 B 要做某事」变成显式的、可组合的事件订阅,而非藏在启动顺序里的隐式假设。ES 的粒度更细(前后置分离),Hadoop 更粗(只一个回调),但思想一致。
七、三个参照系的定位
| 设计维度 | INFINI Gateway(层次1~2) | Hadoop Service(层次3标准) | ES LifecycleComponent(层次3精炼) |
|---|---|---|---|
| 装配 | Setup() |
init() → serviceInit |
构造器 + Guice 注入 |
| 启动 | Start() |
start() → serviceStart |
start() → doStart |
| 停用 | Stop()(含糊) |
stop() → serviceStop |
stop() → doStop(可重启) |
| 销毁 | ❌ 无 | close() = stop() 别名 |
close() → doClose(独立态) |
| 状态机 | bool 标志 | 四态 + 布尔矩阵 | 四态 + switch |
| 幂等 | ❌ 靠自觉 | ✅ 提前 return | ✅ moveToXxx 返回 false |
| 失败处理 | ❌ | ✅ noteFailure + 自动 stop | 抛异常 |
| 失败诊断 | ❌ | ✅ 历史 + 阻塞器 | ❌(分散别处) |
| 模板方法 | ❌ 每模块自己写 | ✅ AbstractService | ✅ AbstractLifecycleComponent |
| 组合编排 | 注册表 + 优先级 | ✅ CompositeService(顺序即依赖) | 手动编排 + toClose LIFO |
| 事件通知 | ❌ | ✅ 单回调 | ✅ 6 钩子 |
定位
- INFINI Gateway:轻量两阶段,解决「顺序」但靠 bool 补丁兜「状态」。
- Hadoop :标准工业范本,状态机 + 模板方法 + 组合服务 + 失败诊断,最偏「可运维」。
- ES:完备但精炼,多了「stop/close 分离」,少了 Hadoop 的失败诊断三件套。
八、设计的本质:三条不断被「显式化」的主线
贯穿四个层次的,是三个不断从「约定」升级为「约束」的东西:
- 顺序 → 阶段化 :把「谁先谁后」从
main里的脆弱知识,变成「装配阶段 vs 启动阶段」(再进一步变成addService顺序)的结构化保证。 - 状态 → 状态机:把「组件现在什么状态」从散落的 bool,变成可校验、可幂等、线程安全、失败可回退的状态机。
- 联动 → 事件:把「A 动 B 跟着动」从逆序约定的隐式依赖,变成显式的事件监听。
这个设计的演化,就是不断把「靠人自觉的约定」升级为「靠框架强制的约束」。 每升级一层,多付出一份复杂度,换取更强的正确性保证和可运维性。
九、如何选择层次
不是越完备越好。选择取决于系统量级:
| 系统特征 | 推荐层次 | 理由 |
|---|---|---|
| 一两个组件、无依赖、起来就不停 | 层次 0 朴素初始化 | 生命周期管理是纯负担 |
| 十几个模块、有依赖、需热更新 | 层次 1 两阶段(INFINI Gateway) | 解决顺序问题,成本最低 |
| 组件需「暂停/重启」、失败要可诊断 | 层次 2 状态机 | 需要 stop/close 区分 + 失败追踪 |
| 几十个强约束组件、分布式引擎 | 层次 3 完备(Hadoop/ES) | 需要模板方法 + 组合服务 + 事件 |
三个升级信号(满足任一就升一层):
- 出现「谁先谁后」的调试噩梦 → 引入两阶段(层次 1)。
- 出现「重复启动 / 关完误启」的 bug,或「服务为什么没起来」难排查 → 引入状态机 + 幂等 + 失败追踪(层次 2)。
- 出现「每个组件抄一套相同的启停代码」或「跨组件联动靠猜」 → 引入模板方法 + 组合服务 + 事件(层次 3)。
十、从INFINI Gateway 升级到工业级的落地顺序
按「成本低、收益高」排序,不必一步到位:
- 加显式状态枚举 :把
actived等 bool 收敛成一个State字段。→ 解决「状态散落」。 - 加转移校验 + 幂等 :
Start/Stop前先判断合法性,非法转移报错、重复调用 no-op。→ 解决「非法操作靠自觉」。 - 加失败追踪:记录「首个异常 + 失败时状态」,init/start 失败自动回退到 stopped。→ 解决「中间态残留 + 难诊断」。
- 模板方法抽取 :把「校验→转移→通知→失败处理」抽到基类,子类只写
serviceInit/serviceStart/serviceStop。→ 解决「样板代码」。 - 组合服务编排:用「子服务列表 + 顺序 init/start + 逆序 stop」取代手写编排。→ 解决「多组件编排」。
- 事件监听器:需要跨组件联动时引入。→ 解决「联动靠约定」。
前两步几乎纯收益,强烈建议;第三到五步是「从能跑升级到可运维」的关键;第六步按需引入。
十一、总结
组件生命周期设计,是一条「把约定升级为约束」的演化路径 :INFINI Gateway 的两阶段初始化解决了「顺序」,Hadoop 的 Service 进一步用「状态机 + 模板方法 + 组合服务 + 失败诊断」解决了「状态」「复用」「编排」「可运维」,ES 的 LifecycleComponent 则用「stop/close 分离 + 细粒度事件」做了精炼变体。