新成员加入堆叠失败排查
新设备接入堆叠后不成为成员、或者长期停留在加载状态，是扩容期最常见的问题。排查按物理连接、型号与版本兼容、成员编号冲突、堆叠口使能、启动状态逐项推进，先把问题缩小到单点，再决定是否需要重启。
基本信息
| 典型现象 | 成员列表不见新设备，或成员状态长期不收敛 |
|---|---|
| 高发原因 | 线缆/光模块故障、编号冲突、版本不兼容、堆叠口未使能 |
| 排查顺序 | 物理层 → 编号与版本 → 配置 → 复位重试 |
| 处置原则 | 先定位单点，不轻易重启整组 |
典型使用场景
- 扩容新设备后成员始终没有加入
- 更换故障成员后状态长期异常
- 演练中模拟成员掉线，验证恢复流程
- 割接前预验证新成员能否顺利入组
- 排障时确认是单点问题还是整组配置问题
排查命令
排查命令
display stack # 全组成员、角色与状态
display stack peers # 成员邻居与链路情况
display stack configuration # 堆叠参数与端口配置
display version # 核对成员版本是否一致排查顺序
| 层次 | 核对内容 | 典型问题 |
|---|---|---|
| 物理层 | 堆叠线两向插牢、指示灯与链路状态 | 线缆或光模块不兼容 |
| 编号 | 新成员编号是否与在网冲突 | 冲突时无法稳定加入 |
| 版本 | 型号与版本是否在兼容清单内 | 版本不一致无法加入 |
| 配置 | 堆叠口是否已使能并绑定 | 端口未转换则链路不生效 |
成员编号冲突时新设备会持续无法稳定入组，改编号需要重启该成员才生效，扩容前先核对在网编号。
光模块不在兼容列表同样可能导致成员不加入，堆叠线缆与模块要整套核对，不能只看线缆是否插牢。
只重启整组会把影响成倍放大：先用显示命令把问题缩小到单点，再决定是否重启。