跳到正文
Lutong's Homepage

华为H3C实战 | 第24章 WLAN 故障排查专题

📚 本系列共 43 篇(第 24 / 43 篇) · 第三卷 无线篇 —— 把网络甩到空中

← 上一篇:第 23 章 AC 高可用  下一篇:第 25 章 路由器基础配置 →


本章导读:同样是"连不上 Wi-Fi",背后可能有二三十种原因。本章不教你背命令,而是给你一套把"不舒服"翻译成"具体病灶"的分层排查法,外加八个高频场景的现象—命令—定位链路。

本章结构:

  • 24.1 功能原理与业务场景 —— 把无线故障切成从物理到应用的七层,说明新手和老手在排查顺序上的差别
  • 24.2 华为设备配置详解 —— 排查要用的诊断配置本身(日志、trace、调试开关怎么开、开完怎么关)
  • 24.3 H3C 设备配置详解 —— H3C 侧对应的诊断手段
  • 24.4 华为 / H3C 命令对照表
  • 24.5 配置验证 —— 八个场景逐个走:AP 不上线、STA 连不上、认证失败、连上上不了网、网速慢、频繁掉线、漫游掉线、新装 AP 不上线,另附求助厂商要交的标准信息清单和三个实战复盘
  • 24.6 排错与故障树 —— 一页纸故障树、全场景速查表、现场标准动作顺序、抓包与工具包、高频误判清单
  • 24.7 新手踩坑与注意事项
  • 24.8 本章小结

重点提示:接到报障先看 24.6.1 的一页纸故障树,30 秒定层,别一上来就翻 AC 配置。已经能上网但慢,直接跳 24.5.5;偶发掉线看 24.6.8 怎么区分"偶发"和"常态"。要打 400 之前先照 24.5.9 采齐信息,否则来回扯皮。 关联章节:WLAN 协议与 CAPWAP 基础见第 18 章;AP 上线流程见第 19 章;认证侧问题见第 21 章;漫游与负载均衡参数见第 22 章;AC 主备切换引起的掉线见第 23 章。

24.1 功能原理与业务场景

24.1.1 这功能是干嘛的(通俗版)

前面六章讲的是"怎么把无线配好",这一章讲的是"配好了但它坏了,怎么修"。

无线故障有个很讨人厌的特点:同样一句"连不上 Wi-Fi",背后可能是二三十种完全不同的原因。 是 AP 没上电?是密码错了?是地址池满了?是出口路由挂了?是 DHCP 被 ACL 挡了?是终端网卡坏了?

这就好比一群人去体检,都说"不舒服",但你得验血、拍片、量血压才能查出到底是哪儿。排查方法论,就是把"不舒服"快速翻译成"具体是什么病"的技巧。

一个新手和老手的差别,不在"谁背的命令多",而在:

新手 老手
一上来就翻 AC 配置 先问"几个人受影响"“哪些地方受影响"“什么时候开始的”
到处乱试 按固定顺序逐层排除
找到一个疑点就马上改配置 先确认是哪个环节,再动手
改完没验证 改完立刻验证并记录
下次遇到同样问题还得重新摸索 上次的排查路径已经记下来了

本章帮你建立这套"老手习惯”。

24.1.2 排查的本质:把"无线故障"切成七层

无线网络从物理到应用有七层,任何一层坏了都会表现为"连不上":

   第 7 层  应用   —— 上网慢、某些网站打不开
   第 6 层  认证   —— 密码错、802.1X 失败、Portal 卡住
   第 5 层  地址   —— 拿不到 IP、IP 冲突
   第 4 层  通路   —— 拿到 IP 但 ping 不通网关
   第 3 层  控制   —— AP 上线失败、CAPWAP 建不起来
   第 2 层  无线   —— 搜不到 SSID、关联失败
   第 1 层  物理   —— AP 没电、网线断、接口 down

排查的核心工作是"判断断在第几层"。一旦知道断在哪层,具体原因就是那一层里很有限的几种可能,排查瞬间变得简单。

判断的依据,就是现象的"卡点":

观察到的卡点 断在第几层
AP 灯不亮 第 1 层
AP 有电但 AC 上没看到它 第 1~3 层
手机上搜不到 SSID 第 2 层
搜得到但连不上 第 2/6 层
连上但显示"正在获取 IP" 第 5 层
拿到 IP 但打不开网页 第 4/7 层

记住这张表,“无线连不上"这句模糊的话就变成了一个明确的检查动作。

24.1.3 排障前的四个"必问”

在现场或者电话里,接到报障时先问这四个问题,能省掉一半的排查时间:

问题 为什么重要 例子
1. 几个人受影响? 1 个人 → 终端侧;一片人 → AP/AC/网络侧 “整层楼都不行” vs “我这台手机不行”
2. 哪些位置受影响? 判断是否与特定 AP / 特定区域相关 “只在会议室” → 会议室那台 AP
3. 什么时候开始的? 对齐变更记录 “今早九点开始” → 昨晚有没有做过变更
4. 是不是新装/新改的? 新装 = 配置问题概率高;老网络突然坏 = 环境/设备变化 “昨天加了台交换机”

第 3 个问题(什么时候开始的)是最有价值的问题,因为绝大多数故障都有"时间锚点":

  • 昨天半夜做过 AC 升级 / 改过配置 / 重启过设备
  • 今早加了新 AP、新交换机
  • 楼下装修打穿了墙
  • 隔壁搬来一家新公司装了一堆 AP

对齐时间点,往往一秒钟就能找到根因。

适用版本:华为 VRP V200R019 及以上(AC6005/AC6605);H3C Comware V7(R2609 及以上,WX3540H 等)。本章命令清单里的命令以官方文档口径为准,凡未核实者均已明确标注。

24.2 华为设备配置详解

本章不是"配置"章,而是"检查"章。23.2 给的是华为 AC 上的排查命令全集,23.3 给 H3C 的。

24.2.1 华为排查命令速查表

检查什么 命令 所在设备
AP 是否上线 display ap all AC
单台 AP 详情 display ap id <N> AC
AP 白名单 display ap mac-auth list AC
CAPWAP 源接口 display capwap config AC
VAP 是否生效 display vap ssid <SSID> AC
在线终端 display station all AC
终端详情 display station sta-mac <MAC> AC
射频状态 display ap id <N> radioall AC
AP 邻居 display ap neighbor AC
AP 版本 display ap version all AC
上行接口 display interface brief AC/交换机
DHCP 分配 display dhcp server ip-in-use 交换机
MAC 学习 display mac-address 交换机
PoE 状态 display poe interface 接入交换机
端口 VLAN display port vlan 交换机

✅ 已核实:上表华为侧的 display ap all、display station all、display station sta-mac <MAC>、display vap ssid、display ap neighbor、display hsb-service、display ac protect 等命令,均已对照华为官方《AC和FIT AP V200R023C00 配置指南》(全文 583 万字)逐条确认存在。注意:查单台终端详情用的是 display station sta-mac <MAC>,不是 display station assoc-info——后者在官方文档中查无此命令。 出处:https://support.huawei.com/enterprise/zh/doc/EDOC1100332873

24.2.2 逐条说明"怎么读"

下面把最常用的几条展开讲"输出怎么读",这是本章最有价值的部分——光有命令不会读,等于没有。

(1)display ap all

# 看所有 AP 的概要状态
display ap all
ID   MAC            Name        Group            IP              Type        State    STA
0    00e0-fc12-3456 AP1F-01     ap-group-office  10.200.1.20     AP4050DN    nor      3
1    00e0-fc12-3457 AP1F-02     ap-group-office  10.200.1.21     AP4050DN    fault    0
2    00e0-fc12-3458 AP1F-03     ap-group-office  -               AP4050DN    -        0

怎么读:

列 关键值 判读
IP 有地址 DHCP 通过;显示 - 说明没拿到地址
State nor 正常上线
State fault 上线失败(认证/CAPWAP/配置任一步断)
State - 或空 AC 根本没见过这台 AP(可能没上线/不在白名单)
STA 数字 该 AP 下终端数

这张表就能直接定位三类问题:没有 IP → 查 DHCP;有 IP 但 fault → 查认证/CAPWAP;完全不在表里 → 查白名单/物理。

(2)display station all

# 看在线终端
display station all
STA MAC           AP Name   Radio  SSID        Online Time  RSSI  SNR
4c77-6600-1234    AP1F-01   0      wlan-office 00:12:33     -48   42
4c77-6600-5678    AP1F-02   1      wlan-office 00:01:02     -78   15

怎么读:

列 判读
Radio 0 = 2.4G,1 = 5G。双频终端大量在 0 上,说明频谱导航有问题
Online Time 很短就掉,说明反复重连(频繁掉线)
RSSI −60 以上良好;−75 以下体验差
SNR 25 以上健康;20 以下速率明显降级

(3)display dhcp server ip-in-use

# 交换机上看地址分配
display dhcp server ip-in-use
IP address       Client MAC          Lease        Type    Pool
192.168.10.20    4c77-6600-1234      Oct 20 2026  Auto    office-sta
10.200.1.20      00e0-fc12-3456      Oct 20 2026  Auto    ap-management

怎么读:看目标终端 MAC 有没有在这一张表里。

  • 有 → DHCP 分配成功,问题在后面(路由/出口/应用)
  • 没有 → 终端的 DHCP 请求没到服务器(VLAN 不对、二层不通、ACL 阻断)

24.3 H3C 设备配置详解

24.3.1 H3C 排查命令速查表

检查什么 命令 所在设备
AP 是否上线 display wlan ap all AC
单台 AP 详情 display wlan ap name <名> verbose AC
AP 运行配置 display wlan ap all running-configuration verbose AC
AP 地址与 SN 列表 display wlan ap all address AC
服务模板状态 display wlan service-template AC
在线客户端 display wlan client AC
客户端详情 display wlan client verbose AC
射频状态 display wlan radio AC
AP 型号信息 display wlan ap-model all AC
DHCP 分配 display dhcp server ip-in-use 交换机

24.3.2 逐条说明"怎么读"

(1)display wlan ap all

# 看所有 AP 状态
display wlan ap all
AP name                     Model            State
ap1f-01                     WA6320           Run
ap1f-02                     WA6320           Idle

怎么读:

State 含义 排查方向
Run 已上线、正在运行 正常
Idle 连不上 AC(Capwap 未建立) 查 Option 43、地址、网络
Join / 中间态 正在上线 再等一会儿;若长期停在此,查认证

(2)display wlan client verbose

# 看某个客户端详情(能看到速率、AKM、WPA3 状态)
display wlan client verbose
MAC address                    : 4c77-6600-1234
AP name                        : ap1f-01
Radio ID                       : 1
SSID                           : wlan-office
VLAN ID                        : 10
RSSI                           : 48
Rx/Tx rate                     : 780/866
Authentication method          : Open system
Security mode                  : RSN
AKM mode                       : PSK
WPA3 status                    : Disabled

怎么读:

  • AKM mode:PSK 说明是个人版,802.1X 是企业版。如果预期是企业版却显示 PSK,说明服务模板配错了。
  • Rx/Tx rate:协商速率。866 是 802.11ac 双流正常值;只有 65 说明信号差或干扰。
  • VLAN ID:授权 VLAN。预期 VLAN 10 却显示别的,是授权问题。

(3)H3C 的 RSSI 与华为相反

H3C 的 RSSI 是 0~100 的"衰减值"(越大越差),华为是负 dBm(越接近 0 越好)。

设备 值 判读
华为 -48 很好
华为 -78 较差
H3C 30 很好(衰减小)
H3C 80 很差(衰减大)

看数值之前先看设备品牌,这是跨厂商排障最容易翻车的地方。

24.4 华为 / H3C 命令对照表

排查目标 华为(VRP) H3C(Comware V7) 差异说明
AP 状态 display ap all display wlan ap all H3C 多 wlan
AP 详情 display ap id N display wlan ap name X verbose 定位方式不同
AP 配置来源 display ap config-info all display wlan ap all running-configuration verbose H3C 能标 (i)/(g) 继承来源
白名单 display ap mac-auth list display wlan ap all address 语义相近
服务/VAP 状态 display vap ssid X display wlan service-template 一个看实例,一个看模板
终端列表 display station all display wlan client 命令名不同
终端详情 display station sta-mac X display wlan client verbose 命令名不同
射频 display ap id N radioall display wlan radio 命令名不同
RSSI 表示 负 dBm 0~100 衰减值 含义相反
DHCP 分配 display dhcp server ip-in-use display dhcp server ip-in-use 相同(交换机命令)

24.5 配置验证

本章的"验证"就是"六种典型故障的完整排查流程"。每个场景都按 SPEC 要求的「现象 → 可能原因(表格)→ 排查命令 → 定位方法 → 处置」写。

24.5.1 场景一:AP 不上线

现象:AP 上电后一直连不上 AC,手机搜不到任何该 AP 的 SSID;AC 上 display ap all 看不到它,或者状态是 fault。

可能原因:

# 可能原因 检查方法 概率
1 AP 没供电 / PoE 功率不足 display poe interface 高
2 AP 没拿到 IP 地址 display ap all 看 IP 列 高
3 Option 43 没配 / 填错 交换机 display current-configuration | include option 43 高
4 AP 不在白名单(MAC/SN) display ap mac-auth list 高
5 CAPWAP 源接口指错 display capwap config 中
6 AP 与 AC 三层不通 AP 同网段 PC ping AC 源地址 中
7 中间设备挡了 UDP 5246 抓包、查 ACL 中
8 AP 型号不在 AC 支持列表 display ap-type 低
9 AP 固件版本与 AC 不兼容 display ap version all 低
10 DTLS 安全模式不匹配 display ap all 状态 低

排查命令与定位方法:

# 第 1 步:接入交换机上确认 AP 接口物理状态与 PoE
display interface GigabitEthernet0/0/5
GigabitEthernet0/0/5 current state : UP
Line protocol current state : UP
# 第 1 步(续):看 PoE 是否在供电
display poe interface
Interface     Power(mW)  PowerStatus
GE0/0/5       15400      Delivering

PowerStatus 不是 Delivering,就直接去查供电,不用看 AC。

# 第 2~4 步:AC 上看 AP 状态与白名单
display ap all
display ap mac-auth list
AP MAC            AP ID   AP Name    AP Group
00e0-fc12-3456    0       AP1F-01    ap-group-office

如果 AP 的 MAC 不在白名单里,而 ap auth-mode 是 mac-auth → 根因确定。

# 第 5 步:确认 CAPWAP 源接口
display capwap config
Source Interface    : Vlanif200
Source IPv4 Address : 10.200.1.2

处置:按上面定位到的环节处理:

  • 没供电 → 查 PoE 电源/线缆
  • 没 IP → 查 DHCP 池/VLAN/PVID
  • Option 43 缺 → 补配(第 19 章)
  • 不在白名单 → ap-id 0 ap-mac <MAC> 添加
  • 源接口错 → 改成 AP 可达的接口
  • 端口不通 → 放行 UDP 5246

24.5.2 场景二:STA 连不上(搜不到 / 连不上 / 拿不到 IP)

现象:手机/笔记本搜不到 SSID,或者搜到了连不上,或者连上了拿不到 IP。

可能原因:

# 现象细分 可能原因 检查命令
1 搜不到 SSID VAP 没绑射频 / 射频没开 display vap ssid <SSID>
2 搜不到 SSID SSID 被隐藏 看 ssid-profile 配置
3 搜不到 SSID 国家码导致信道不可用 display ap id N
4 搜到连不上 密码错 终端提示
5 搜到连不上 加密方式终端不支持 终端型号
6 搜到连不上 AP 达到最大接入数 display station all 计数
7 连上无 IP 地址池耗尽 display dhcp server ip-in-use
8 连上无 IP 业务 VLAN 未在 AC 上配三层接口 AC display ip interface brief
9 连上无 IP 直接转发时交换机没放行业务 VLAN display port vlan
10 连上无 IP DHCP 被 ACL 阻断 display acl all

排查命令:

# 确认 VAP 是否真的生效
display vap ssid wlan-office
SSID    : wlan-office
Status  : ON
AP Name : AP1F-01
Radio ID: 0
# 确认终端是否关联上
display station all

处置:

  • VAP OFF → 查 AP 组绑定 / 射频开关
  • 终端不在 display station all 里 → 关联失败,查密码/加密方式/最大接入数
  • 在列表里但没有 IP → 查 DHCP → 查 VLAN → 查 ACL

24.5.3 场景三:认证失败

现象:终端提示"身份验证失败"“用户名或密码错误”,或 802.1X 卡在"正在验证"。

可能原因:

# 可能原因 检查方法
1 账号密码错 先用 test-aaa 测
2 RADIUS 服务器不可达 AC 上 ping 服务器
3 共享密钥不一致 逐字符比对两侧
4 域不存在 / 缺省域未配 display aaa configuration
5 EAP 方式不匹配 与服务器管理员确认
6 服务器证书过期 服务器侧查证书有效期
7 用户名格式(带不带域名)不对 user-name-format 配置
8 802.1X 未在 WLAN 侧启用 display security-profile
9 认证成功但授权失败 服务器授权属性
10 并发认证过多 服务器/AC 性能

排查命令:

# 关键一步:绕过无线,直接测 AAA
test-aaa zhangsan@acme.com Test@123 radius-template wlan-radius

定位方法:

test-aaa 结果 结论
成功 RADIUS 链路正常,问题在无线侧(安全模板、终端)
失败 问题在 RADIUS 侧(网络、密钥、服务器策略)

处置:按 20.6 的认证排错表处理。

24.5.4 场景四:连上了上不了网

现象:终端能连上 Wi-Fi、能拿到 192.168.10.x 地址,但打不开网页、上不了网。

可能原因:

# 可能原因 检查方法
1 网关不可达(VLAN 配置错) 终端 ping 网关
2 出口路由缺失 display ip routing-table
3 NAT 未配或配错 路由器 display nat session(华为)
4 DNS 不通 终端 ping DNS 地址
5 认证未通过(Portal 未登录) 看是否被重定向
6 ACL 误阻断 display acl all
7 授权 VLAN 不对(VLAN 20 而非 10) display station 看 VLAN
8 防火墙安全策略未放行 防火墙策略
9 终端代理/DNS 设置异常 终端侧设置

排查命令(分层验证):

   ① 终端 ping 192.168.10.1(网关)     → 不通:VLAN/三层问题
   ② 终端 ping 192.168.10.10(DNS)     → 不通:同网段不通,二层/VLAN 问题
   ③ 终端 ping 114.114.114.114          → 通但网页打不开:DNS 问题
   ④ 浏览器访问 IP 直连的网页            → 测是否只是 DNS 问题

处置:

  • ping 网关不通 → 查 AC 的业务 VLANIF、交换机 VLAN、ACL
  • ping 通但上不了外网 → 查出口路由/NAT/防火墙策略
  • 能用 IP 访问、域名不行 → 查 DNS
  • 显示被重定向到登录页 → Portal 认证未完成

24.5.5 场景五:网速慢 / 丢包

现象:连上了、能上网,但速度很慢、视频卡顿、下载慢,或 ping 有丢包。

可能原因:

# 可能原因 检查方法 特征
1 信号弱 display station all 看 RSSI 特定位置慢
2 同频干扰 射频信道利用率 信号好但速率低
3 信道利用率高 利用率 > 70% 人多时慢
4 2.4G 拥堵 终端在 Radio 0 5G 更快
5 单 AP 超载 单射频终端数 > 40 附近人都慢
6 上行口协商成百兆 交换机 display interface brief 单台 AP 慢
7 AP 上行带宽瓶颈 AC 上行口利用率 整体慢
8 出口带宽跑满 出口设备流量 所有人都慢
9 终端自身问题 换终端对比 只有一台慢
10 微波炉/无线设备干扰 现场排查 特定时段慢

排查命令:

# 看终端的信号、速率
display station sta-mac 4c77-6600-1234
RSSI(dBm)    : -78
SNR(dB)      : 15
Tx Rate(Mbps): 130
Rx Rate(Mbps): 117

RSSI -78 / SNR 15 / Rate 130 是一组典型的"信号弱"组合 → 根因是覆盖不足,不是设备故障。

# 看交换机接口协商速率(排查上行口降速)
display interface brief
Interface    PHY  Protocol  InUti  OutUti  Bandwidth
GE0/0/5      up   up        2%     8%      1000M
GE0/0/6      up   up        15%    60%     100M      ← 只协商到百兆!

处置:

  • 信号弱 → 补 AP / 调信道功率
  • 干扰重 → 换信道 / 引导到 5G
  • 超载 → 负载均衡 / 加 AP
  • 上行降速 → 换网线/查接口
  • 出口满 → 扩容或限速

24.5.6 场景六:频繁掉线

现象:能连上,但经常掉线重连;或者用一段时间就断。

可能原因:

# 可能原因 检查方法 特征
1 AP 与 AC 之间链路不稳 display ap all 看 Uptime 是否重置 全部终端一起掉
2 弱信号漫游失败 终端侧 RSSI 走动时掉
3 粘性客户端 看 RSSI 是否 < −80 特定终端
4 认证会话超时 RADIUS 服务器策略 固定时间间隔掉
5 AP 重启 AP 日志 AP 的 Uptime
6 终端节能策略 终端侧 特定型号
7 802.11 重传过高 重传率 信号好也掉
8 频段切换频繁 看终端在 2.4G/5G 间跳 双频终端
9 交换机端口错包 display interface 错包计数 AP 频繁掉
10 PoE 功率不足 display poe interface AP 间歇重启

排查命令:

# 看 AP 的在线时长(Uptime 很小说明 AP 在反复掉线)
display ap all
ID   MAC            Name      State  STA  Uptime
0    00e0-fc12-3456 AP1F-01   nor    3    00:00:35     ← Uptime 才 35 秒!

Uptime 是判断"AP 是否反复掉线"最直接的证据:如果明明运行了一整天,Uptime 却只有几十秒,说明它一直在重启或重连。

# 看交换机接口的错包统计
display interface GigabitEthernet0/0/5
Input errors: 1523
CRC: 1523

CRC 错包在增长,基本就是物理层问题(网线、水晶头、光模块)。这是"频繁掉线"最常被忽略的原因——大家都盯着 AC 查,其实是网线坏了。

24.5.7 场景七:漫游相关问题(跨 AP 掉线)

现象:用户在使用过程中从一个房间走到另一个房间,或者从走廊走到工位,就会出现短暂断网、视频卡顿,甚至直接掉线重连。

可能原因:

# 可能原因 检查方法 特征
1 覆盖有"信号夹缝" display ap neighbor 相邻 AP 的 RSSI < −80
2 粘性客户端(终端赖着不走) display station all 看 RSSI 终端长期处在 −80 以下还不换
3 漫游时延太大 走动测试 ping 每次换 AP 都丢一堆包
4 跨 VLAN 三层漫游未配好 漫游后 IP 是否变化 换 AP 后 IP 变了
5 未启用 802.11k/v/r 终端与 AP 能力 切换慢、重认证久
6 漫游门限设置不当 看 roaming 配置 切换过早或过晚
7 终端驱动问题 换终端对比 只有特定型号有问题
8 AP 之间不属同一 AC 多 AC 组网 漫游后需要重新认证

排查命令:

# 华为:看 AP 之间能不能听到
display ap neighbor
AP ID  AP Name   Neighbor ID  Neighbor Name  RSSI
0      AP1F-01   1            AP1F-02        -88     ← 太弱,漫游带不足

定位方法:相邻 AP 的 RSSI 低于 −80,说明两台 AP 之间没有足够的覆盖重叠,用户走到中间会先掉线,然后才重新连上。这属于规划问题,不是配置可以解决的,需要补 AP 或调整功率。

# 看终端的 RSSI 是否长期过低(粘性客户端的证据)
display station all
STA MAC           AP Name   Radio  RSSI  SNR   Online Time
4c77-6600-1234    AP1F-01   1      -84   10    01:20:33     ← 弱信号还连着

RSSI -84 / SNR 10 且 Online Time 很长,是典型的粘性客户端。

处置:

  • 覆盖有断层 → 补 AP / 调功率(第 22 章)
  • 粘性客户端 → 开弱信号踢除 / 漫游引导
  • 切换慢 → 开 802.11k/v/r(前提是终端支持)
  • IP 变了 → 检查是不是跨了 VLAN,改成统一终端 VLAN 实现二层漫游

24.5.8 场景八:新装 AP 上不了线(区别于"原来好的突然坏")

“新装 AP 上不了线"和"原来好的 AP 突然坏了"是两类问题,排查重心不一样:

新装 AP 上不了线 原来好的 AP 突然坏
时间特征 从来没有上线过 之前正常,某时间点开始异常
首要怀疑 配置层面的遗漏(白名单、Option 43、型号不支持) 环境/硬件变化(断电、网线、开关、AP 换位)
验证方式 与"能正常工作的 AP"做差分对比 对照变更记录

新装 AP 的排查顺序:

   ① 这台 AP 型号在 AC 支持列表里吗?(`display ap-type`)
   ② 这台 AP 的 MAC/SN 在白名单里吗?(`display ap mac-auth list`)
   ③ 它和别的 AP 接的是不是同一个管理 VLAN?
   ④ 这台 AP 有没有和其他 AP 一样的 AP 组?
   ⑤ 和其他能上线的 AP 逐项对比配置

“差分法"是新装排查最快的武器:找一台已经正常上线的同型号 AP,把两台 AP 的接线、VLAN、白名单、AP 组、固件版本逐项对比。差异点往往就是答案。

24.5.9 采集信息求助厂商的标准清单

排查到最后可能确实需要厂商支持。给厂商报障时,提供的信息质量直接决定问题解决速度。 下面这份清单来自一线经验,照着准备,能少来回好几轮:

   ┌────────────────────────────────────────────────────────────┐
   │ 一、基本信息                                                │
   │   □ 设备型号、软件版本(display version)                   │
   │   □ AP 型号、固件版本(display ap version all)             │
   │   □ 组网拓扑(画个图,标出 AC/交换机/AP/出口)              │
   │   □ 故障开始时间、影响范围                                  │
   ├────────────────────────────────────────────────────────────┤
   │ 二、配置                                                    │
   │   □ AC 的 display current-configuration(可脱敏)           │
   │   □ 相关 AP 的配置(display ap config-info)                │
   │   □ RADIUS 配置(如果有认证)                               │
   ├────────────────────────────────────────────────────────────┤
   │ 三、现场状态                                                │
   │   □ display ap all(全部 AP 状态)                          │
   │   □ display station all(全部终端)                         │
   │   □ display capwap config                                   │
   │   □ 故障终端的具体 MAC 与关联详情                            │
   ├────────────────────────────────────────────────────────────┤
   │ 四、日志                                                    │
   │   □ AC 的系统日志(display logbuffer)                      │
   │   □ AP 的日志(如果可取)                                   │
   │   □ 交换机接口统计(display interface)                     │
   ├────────────────────────────────────────────────────────────┤
   │ 五、已做过的尝试                                            │
   │   □ 试过什么、结果如何、什么时候试的                        │
   └────────────────────────────────────────────────────────────┘

第 5 项最容易被忽略,但最有用:厂商工程师最想知道的是"你已经排除了什么”,这样他们不会重复你的工作。

24.5.10 实战场录:三个真实故障的排查全过程

前面按"场景"分类讲,这里换一个角度:按真实发生顺序,原样记录三次现场排查。看老手怎么"走"过一条排查路径,比看清单更容易学到东西。

(1)录:整个 2 楼无线都上不了网,但 1 楼正常

时间 动作 结果 推断
0 分 用户报"2 楼无线全断” 1 楼正常 不是全网故障,范围在 2 楼
3 分 问:最近改过什么 昨晚有人加了一台 2 楼的接入交换机 重大线索
6 分 AC display ap all 2 楼的 AP 全部 State: -(不在线) AP 根本没上线
10 分 2 楼新交换机 display interface brief AP 口 down 物理层问题
12 分 检查新交换机的配置 没有配置管理 VLAN 200 根因
20 分 给新交换机补 VLAN 200 + AP 口 access 200 AP 陆续上线 恢复

根因:新加的接入交换机没有配 AP 管理 VLAN,AP 接上去拿不到管理地址。“昨晚有人加了设备"这句话直接指向了根因——这就是为什么排障第一步要问变更。

(2)录:某个会议室无线很卡,但信号满格

时间 动作 结果 推断
0 分 报障:“会议室 Wi-Fi 卡” 信号满格 不是覆盖问题
4 分 display station sta-mac 看终端 RSSI −45,SNR 40,但 Rate 只有 100Mbps 信号极好但速率低 → 干扰
8 分 看该 AP 射频信道利用率 88% 空口被占满
12 分 现场勘查会议室 有无线投屏器、无线麦克风、无线摄像头 找到了干扰源
15 分 换信道 + 引导终端到 5G 利用率降到 25% 恢复

根因:会议室里有大量其他无线设备在 2.4G 频段工作,把空口占满了。“信号满格但很慢"几乎必然是干扰或拥塞,这时候调功率、调门限都是白费力气。

(3)录:每天早上 9 点整,几百人连不上Wi-Fi

时间 动作 结果 推断
0 分 报障:“每天 9 点连不上,9 点 20 就好了” 有明确时间规律 不是配置问题,是容量问题
5 分 看 AC 负载 9 点时认证请求暴增 认证并发超限
10 分 看 RADIUS 服务器 CPU 打满,响应超时 服务器成为瓶颈
15 分 检查 RADIUS 超时/重试配置 timeout 只有 2 秒 超时后重传加剧拥塞
25 分 调大 timeout + 加认证缓存 + 提示服务器扩容 上午 9 点恢复正常 缓解

根因:早上全员上班时,几百人同时发起 802.1X 认证,把 RADIUS 服务器打满。“固定的时间点出问题"是容量问题的经典特征,与"随机时间出问题”(多为故障)形成鲜明对比。

三个案例的共同点:根因都不是"配置写错了”,而是"环境变了”(新设备、新干扰源、新负载)。这也是为什么排障不能只盯着配置看。

24.6 排错与故障树

24.6.1 一页纸故障树(贴在机房里那种)

下面这棵故障树是本 Part 所有排障知识的总纲,打印出来贴机房很实用:

                     无线有问题?
                          |
              ┌───────────┴───────────┐
         一台设备              全部/一片设备
              |                        |
        终端侧问题                AP 侧 / AC 侧 / 网络侧
              |                        |
  ┌───────────┴─────────┐    ┌─────────┴──────────┐
 换终端试              查其  AP 是否上线?      终端能拿地址?
 是否同样问题           他用户    |                    |
   |        |            |   否→第1~3层         否→第5层
  是→终端  否→网络        |   是→继续            是→第4/7层

24.6.2 全场景速查表

卡点 断在哪层 首查命令
AP 灯不亮 物理 display poe interface
AP 有电,AC 看不到 发现 Option 43、display capwap config
AP 看到但 fault 认证 display ap mac-auth list
搜不到 SSID 无线/VAP display vap ssid X
搜到连不上 认证 终端提示、display station all
连上无 IP 地址 display dhcp server ip-in-use
有 IP 打不开网页 数据/出口 ping 网关、display ip routing-table
慢 性能 display station sta-mac、利用率
频繁掉线 稳定 display ap all 的 Uptime、接口错包

24.6.3 一个"排错失败"的典型反面案例

案例:某公司报"3 楼会议室无线老断"。

新手做法:直接跑到 AC 上,发现会议室那台 AP 的信号弱,就把功率从 14 调到 23。结果——问题更严重了,因为功率开大后 AP 和旁边 AP 互相干扰,整个 3 楼都慢。

老手做法:

  1. 问:几个人受影响?→ 会议室里 10 个人。
  2. 问:什么时候开始的?→ 上个月开始。
  3. 问:有没有变更?→ 上个月会议室加了个新的无线投屏器。
  4. 查:会议室 AP 的信道利用率 → 85%(异常高)。
  5. 判断:投屏器在 2.4G 上发射,且就在会议室里。
  6. 处置:把会议室 AP 的 2.4G 信道换到远离投屏器的,同时引导终端走 5G。
  7. 结果:利用率降到 30%,问题解决。

这个案例的教训:“信号弱"的直觉判断在无线里经常是错的。老手先问"变更了什么”,因为 90% 的突发故障都是变更引起的。

24.6.4 现场排查的"标准动作顺序"

把前面所有方法压缩成一个可以背下来的顺序,现场照着走就行:

   第 1 步  看灯          —— 30 秒,判断物理层
   第 2 步  问人          —— 2 分钟,圈定范围(几个人/哪片区域/什么时候)
   第 3 步  AC 看 AP      —— 1 分钟,判断 AP 是否在线
   第 4 步  AC 看终端     —— 1 分钟,判断是否关联上
   第 5 步  交换机看 DHCP —— 2 分钟,判断是否拿到地址
   第 6 步  交换机看端口  —— 2 分钟,判断 VLAN/错包
   第 7 步  ping 分层     —— 2 分钟,判断第 4/7 层
   第 8 步  看性能        —— 2 分钟,判断是否容量问题

这套顺序的价值:每一步都在缩小范围,而且都不需要改配置。真正动手改配置,往往是最后一步才做的事。

24.6.5 排障工具包:除了敲命令,还能用什么

命令行的局限是"只能看到设备想让你看到的东西"。实际排查中,下面这些工具能补上盲区:

工具 作用 什么时候用 获取难度
抓包(Wireshark + 监听模式网卡) 看 802.11 帧:Beacon、Probe、认证帧、deauth 帧 排查"关联失败"“莫名掉线” 中(需要监听网卡与驱动支持)
交换机端口镜像 把 AP 口的流量镜像到分析口 排查"AP 与 AC 之间丢包" 低(交换机命令)
手机 Wi-Fi 分析 App 看周围 SSID、信道占用、RSSI 现场快速判断信道拥堵 极低
AC 的日志/告警 看设备事件流(AP 授权失败、漫游事件、DHCP 异常) 所有场景 低(display logbuffer)
AP 指示灯 设备状态的最直观指示 物理层快速判断 极低
频谱分析仪 全频段能量分析,定位非 Wi-Fi 干扰 疑有环保设备/微波炉干扰 高(需采购)

(1)抓包怎么抓"关联失败"

抓包在实际排障里价值极高,但要注意:普通的网卡抓不到 802.11 管理帧,需要支持"监听模式(Monitor Mode)“的网卡。

抓包后过滤出关键帧,按顺序看:

   ① Probe Request/Response(扫描)
   ② Authentication Request/Response(链路层认证)
   ③ Association Request/Response(关联)
   ④ EAPOL 帧(如果是 802.1X 或 WPA 握手)
   ⑤ Deauth / Disassoc 帧(断开原因)

哪一步没回应,就是断点在哪一步。 例如:

  • 只看到 Probe Request 没有 Response → AP 没在响应(SSID 隐藏 / AP 有问题)
  • Authentication 没有 Response → 拒绝了(可能是黑名单)
  • Association 被拒 → 看返回的 Status Code(比如 “已满”、“不支持速率”)
  • 连上后马上有 Deauth → 看 Reason Code(比如 “因不活动被踢”、“信号差被踢”)

Reason Code 是最有价值的线索,它直接告诉你"谁把谁踢了、为什么”。

(2)端口镜像排查"AP 与 AC 之间"的问题

怀疑 AP 和 AC 之间丢包时,在交换机上把 AP 口镜像到分析口,抓 UDP 5246/5247:

# 华为交换机:把 AP 口镜像到分析口
observe-port 1 interface GigabitEthernet0/0/20
interface GigabitEthernet0/0/5
 port-mirroring to observe-port 1 inbound
 port-mirroring to observe-port 1 outbound
 quit

镜像后抓包看什么:

  • CAPWAP Echo 是否双向都有(单向有说明回程被丢)
  • 有没有大量重传(说明链路质量差)
  • 有没有 ICMP unreachable / 错误响应

(3)日志是最被低估的工具

很多故障在发生的那一刻,设备已经"喊"过了:

# 华为:查看设备日志
display logbuffer
WLAN/4/AP_AUTH_FAIL: AP authentication failed. (AP MAC: 00e0-fc12-3457, ...)
WLAN/4/AP_JOIN_FAIL: AP join failed. (AP MAC: ..., Reason: ...)
DHCP/3/ADDRESS_CONFLICT: IP address conflict ...

看到 AP_AUTH_FAIL 就直接去查白名单;看到 ADDRESS_CONFLICT 就直接去查 IP 冲突——日志里往往已经写着答案。

24.6.6 “排查完就完了"吗?——把故障变成资产

这是很多网管忽略的一步,也是区分"熟练"和"资深"的分水岭。

每一次故障排查,都应该沉淀成三样东西:

沉淀物 内容 价值
故障记录表 现象/时间/根因/处置/耗时 下次同类问题直接查表
检查项更新 把这次的根因加进巡检清单 防止同类问题复发
变更记录关联 记录"本次故障由 X 日的变更引发” 以后类似变更更加谨慎

一个简单的做法:建一个表格,字段就四列——「现象 / 根因 / 处置 / 耗时」。每次修完填一行。半年之后,这张表就是你自己的"实战经验库",比任何手册都贴合你的环境。

再进一步:同一类根因重复出现三次以上的,就要考虑"系统性解决"(比如"白名单漏配"反复出现,就改成"新 AP 上架必须走工单,工单里带白名单配置"的流程)。

24.6.7 高频误判清单(“你以为的"和"实际上的”)

排障中最花时间的是"走错方向"。下面这些误判几乎每个网管都踩过一遍,列出来是希望你少踩:

你以为的 实际上可能是 怎么区分
“信号满格就是好” 信号满格但干扰严重,速率可能极低 看 SNR 与信道利用率,不只看 RSSI
“连不上就是密码错” 可能是 AP 满了、可能是 DHCP 没地址 看终端是否出现在 display station all
“网速慢就是带宽不够” 可能是空口拥塞、可能是该 AP 上行降速 换终端/换 AP 对比
“重启一下就好了” 重启是掩盖问题,不是解决问题 重启后观察是否复发,复发则必须查根因
“换个新 AP 就好了” 问题可能在交换机、在线路 换 AP 前先在原位置用同型号试
“AC 配置错了” 实际上可能是 DHCP 服务器地址池满了 先看地址池使用率
“用户设备坏了” 可能是该用户所在位置的覆盖/干扰 换终端到同一位置测
“加个 AP 就能解决” 可能是干扰,加 AP 反而更糟 先测信道利用率
“开了自动调优就万事大吉” 自动调优在复杂环境下可能调整不当 调优后必须实测验证
“看不到报错就是没问题” 很多故障没有报错,只是质量差 用质量指标(丢包、时延、重传)判断

“重启一下就好了"这一条特别值得强调:重启确实能让问题"消失”,但它没有解决任何问题,只是把故障从"连续"变成了"间歇"。对真实运维来说,间歇性故障比持续故障更难查,因为它更难复现。所以重启之前,一定要先把现场状态留下来(display ap all、日志、终端详情截图),否则重启后线索就没了。

24.6.8 时间与频率:怎么判断"偶发"和"常态"

排障时,“问题多久出现一次"是非常重要的判据:

频率特征 通常指向 排查重点
一直存在 配置错误 直接比对配置
固定时间出现 环境/负载(微波炉、上班高峰、夜间备份) 对齐时间点找对应事件
随机偶发 链路质量、终端问题、外部干扰 抓包、看错包计数、长期监控
只在特定位置 覆盖/局部干扰 现场测信号与干扰
只在特定终端 终端硬件/驱动/系统 换终端对比

“固定时间出现"和"一直存在"这两个差别,直接决定你该查什么。 很多新手把"每天中午断"当成"配置问题"来查,白费一天时间。

24.7 新手踩坑与注意事项

  1. 一上来就改配置——症状:越改越乱,原来能用也不好用了。避开:先"只看不改”,定位到具体环节再动手。
  2. 不问"什么时候开始的”——症状:排查半天,错过了"昨晚有人改过配置"这个关键线索。避开:报障第一句话就问时间点。
  3. 改完不验证——症状:以为修好了,用户还是那样。避开:每次改完立刻用同样的方法验证原问题。
  4. H3C 的 RSSI 当华为的看——症状:判断反了。避开:华为负 dBm,H3C 0~100 衰减值。
  5. 只查 AC 不查交换机——症状:查了半天 AC 没问题,问题在网线。避开:交换机侧的 CRC 错包、PoE 状态、协商速率都要看。
  6. 把"信号弱"当成唯一原因——症状:一味加功率,越加越糟。避开:信号弱、干扰、拥塞是三种不同的"慢",处置完全不同。
  7. 不看 AP 的 Uptime——症状:没发现 AP 在反复重启。避开:display ap all 第一眼看 Uptime。
  8. 排查完不记录——症状:下次同样问题又从头查。避开:每次排障写一条"现象-根因-处置",积累成自己的故障库。
  9. 不说"我查过了没问题"——症状:用户和监督都不信。避开:给出具体数据(“信道利用率 85%,所以是干扰”)。
  10. 改动不做变更记录——症状:自己改的自己也忘了,下次排查被误导。避开:任何配置改动都记时间、改了什么、为什么改。

24.8 本章小结

24.8.1 要点清单

  • 无线故障排查的本质是"判断断在第几层":物理/无线/控制/通路/地址/认证/应用。
  • 排障前必问四句:几个人?哪些位置?什么时候开始?最近改了什么?
  • 六种典型场景:AP 不上线、STA 连不上、认证失败、连上无网、网速慢、频繁掉线。
  • 黄金分界线命令:
    • display ap all 判断 AP 是否在线
    • display station all 判断终端是否关联
    • display dhcp server ip-in-use 判断是否拿到地址
    • test-aaa 判断 RADIUS 通不通
    • display interface 看 CRC 错包判断物理层
  • AP 的 Uptime 是判断"是否反复掉线"最直接证据。
  • 先只看不改,定位清楚再动手,改完立刻验证。
  • 跨厂商差异:H3C 命令多 wlan 前缀,H3C 的 RSSI 是衰减值不是负 dBm。

24.8.2 自测题

  1. 用户报"无线连不上",你会先问哪四个问题?为什么?
  2. AP 在 display ap all 里显示 State: nor 但 IP 是 -,这种组合可能吗?说明了什么?
  3. 终端拿到 192.168.10.x 地址但 ping 不通网关 192.168.10.1,你的排查顺序是什么?
  4. display ap all 里某台 AP 的 Uptime 只有 30 秒,但实际上已经运行一天了。这说明什么?
  5. 如何快速判断"认证失败"是无线侧问题还是 RADIUS 侧问题?
  1. ① 几个人受影响?(区分单终端与大面积)② 哪些位置受影响?(定位是否与特定 AP 相关)③ 什么时候开始的?(对齐变更记录,往往一眼找到根因)④ 最近有没有做新装或配置变更?(新装多为配置问题,老网络突然坏多为环境/设备变化)。
  2. 不太可能同时出现:State: nor 表示已正常上线,说明它已经通过 DHCP 拿到了管理 IP;若 IP 显示 - 通常意味着没拿到地址、还没上线成功。如果真出现,应检查是不是显示延迟或该 AP 通过其他方式(静态地址)上线,但正常判断以"没 IP = 没上线成功"为准。
  3. ① 终端 ping 网关(先判断三层可达);② 检查 AC 上的业务 VLAN 三层接口是否存在且 UP(display ip interface brief);③ 检查核心交换机上 Vlanif10 状态、VLAN 10 是否有成员端口(display vlan 10);④ 检查是否有 ACL 阻断;⑤ 若为直接转发,检查 AP 口 trunk 是否放行 VLAN 10。
  4. 说明这台 AP 在反复重启或反复掉线重连。Uptime 只统计本次运行时长,30 秒意味着它刚上线不久。应检查 AP 供电(PoE 功率)、AP 上行链路质量(CRC 错包)、AP 与 AC 之间链路稳定性。
  5. 用 test-aaa 命令绕过无线直接在 AC 上测试 RADIUS 认证:通了说明 RADIUS 链路正常、问题在无线侧;不通说明问题在 RADIUS 侧(网络、共享密钥、服务器策略),与无线配置无关。

关于本书:《华为 / H3C 网络设备典型功能配置详解》—— 面向国内高校/企业网络环境, 华为 VRP 与 H3C Comware 双厂商并排配置的实操教材,共 43 章。 全书所有命令尽量有官方出处,查不到的显式标注「待核实」。 返回系列目录