err-disable 是什么
err-disable 是 Cisco 交换机的一种端口保护状态：当端口触发某个保护特性（如 BPDU Guard、链路震荡、风暴抑制动作、端口安全违规或 UDLD 判定异常）时，端口被自动关闭。它通常附带可读的原因，排查第一步是看原因而不是直接恢复端口，否则同类问题会反复出现。
基本信息
| 适用平台 | Cisco IOS / IOS-XE 交换机 |
|---|---|
| 查看原因 | show interfaces status err-disabled |
| 查看恢复策略 | show errdisable recovery |
| 恢复方式 | 按原因修复后手动恢复，或配置自动恢复 |
| 常见触发源 | BPDU Guard、链路震荡、风暴抑制、端口安全、UDLD |
| 排查顺序 | 先读原因，再修根因，最后恢复端口 |
典型使用场景
- 端口无故关闭，业务中断需要快速定位原因
- 接了交换机到边缘端口，BPDU Guard 触发关闭
- 链路反复 up/down 触发 link-flap 保护
- 配置自动恢复前的评估：确认根因已排除
查看与恢复
查看与恢复
show interfaces status err-disabled # 列出被禁用的端口与原因
show errdisable recovery # 查看各原因的自动恢复配置
show interfaces GigabitEthernet1/0/1 # 端口详情
show log | include ERR_DISABLE # 日志中查看触发时间点
# 恢复（确认根因已处理后）
interface GigabitEthernet1/0/1
shutdown
no shutdown # 或使用 errdisable recovery 自动恢复常见原因对照
| 原因 | 触发机制 | 处置方向 |
|---|---|---|
| bpduguard | 边缘端口收到 BPDU | 排查是否误接交换机或私接设备 |
| link-flap | 链路震荡超阈值 | 查光路、跳线与模块质量 |
| storm-control | 风暴超过阈值且动作为 shutdown | 定位风暴来源后解除 |
| port-security | 违规 MAC 接入 | 核对合法 MAC 列表与接入设备 |
| udld | 单向链路判定 | 按单向链路流程排查后恢复 |
先查触发原因再恢复端口，否则会反复进入 err-disable；自动恢复配置适合原因明确且可自愈的场景，不适合需要人工确认的场景。
原因查看命令随平台不同，先核对设备支持的特性集；部分平台的原因名称与日志关键字与文档略有差异，以上机输出为准。