AC是EWP-WA2520X-LI，AP是EWP-WA5320-C-FIT

# 故障现象

AC：WX2520X‑LI；AP：WA5320‑C‑FIT
Mac 笔记本在**特定这台 WA5320‑C‑FIT AP 下反复上下线、一会断一会连**；Windows / 其他终端在该 AP 正常；Mac 切换到其他 AP 连接完全正常。

>
> 特征：故障只发生在【Mac + 这一台 AP】组合，排除全局 AC、SSID、认证、DHCP 全局问题，问题锁定在该 AP 射频参数、版本 bug、空口环境、苹果终端兼容性（PMF/802.11k/v）、该 AP 上行链路局部异常。

## 一、AC 命令行抓取掉线根因（优先做，最重要）

先拿到 Mac 的无线网卡 MAC 地址，在 AC 上复现故障时执行：

```
#查看该Mac终端详情，看RSSI、SNR、关联速率、下线记录
display wlan client mac-address XXXX‑XXXX‑XXXX verbose

#查看终端历史上下线记录，看每一次下线的reason‑code
display system internal wlan client history‑record normal‑online‑offline

#根据返回的原因码查官方解释
display system internal wlan client history‑record help reason‑code xxx
```

>
> 重点看下线原因：是**终端主动解除关联**、AP 发送 deauth、重传超时、PMF 保护帧报错、漫游触发下线等。

## 二、配置层面排查（苹果设备高频兼容坑）

### 1）PMF（管理帧保护）问题（Mac 最常见）

若服务模板配置 PMF `mandatory（强制）`，部分 macOS 版本会出现间歇性断连，Windows 设备不敏感表现正常。

- 建议修改为`optional`（可选），不要强制 PMF：

```
wlan service‑template name xxx
security‑ie dot11ae pmf optional
```

>
> 现象：其他 AP 正常，只有这台 AP 异常，有可能该 AP 射频模板继承 / 单独配置了强制 PMF。

### 2）802.11k/v 漫游协议兼容性

Mac 对 11k/v 实现较激进，如果 AP 固件版本存在 11kv 缺陷，会出现局部 AP 下频繁掉线，别的 AP 正常。
临时测试：在该 AP 所属 ap‑group 的 radio 视图下关闭 11k/v，复现故障观察是否改善：

```
wlan ap‑group name xxx
radio‑5g
undo dot11k enable
undo dot11v enable
```

>
> 如果关闭后 Mac 不再掉线，就是版本对 11kv 兼容问题，**最终方案升级 AC/AP 固件版本**，不要长期关闭 11k/v 功能。

### 3）弱信号踢客户端 / 弱信号拒绝接入

检查该 AP radio 是否配置 rssi‑kick（弱信号踢人），阈值设置太高，Mac 发射功率比 Windows 低，同等位置 Mac 侧 RSSI 更低，被踢下线，Windows 没事。

```
display current‑configuration wlan ap‑group name xxx | include rssi‑kick
```

临时测试：**关闭弱信号踢出**，观察 Mac 稳定性。

### 4）频宽与信道

WA5320‑C‑FIT 的 5G 射频：

- 不要盲目开 160MHz；优先使用 80MHz，避开高干扰信道；
- 观察该 AP 的信道利用率、底噪：

```
display wlan ap name WA5320‑C‑FIT radio 2 statistics
```

>
> 信道利用率 > 70%、底噪过高，空口冲突会导致苹果网卡更容易断连，Windows 容忍度更高。

## 三、该 AP 硬件 & 上行链路排查（只单台 AP 出问题）

1. 确认 AP 本身运行状态：

```
display wlan ap name WA5320‑C‑FIT verbose
```

观察 CPU、内存，CAPWAP 隧道是否稳定，AP 是否隐性重启。
2. 检查 AP 接入交换机端口：

- 看端口 CRC 错误、丢包；更换网线、更换 PoE 端口测试；

>
> 上行链路轻微丢包，Windows 可以容忍，macOS 无线协议栈敏感，会表现为反复断连。

3. AP 固件版本：对比这台 WA5320‑C‑FIT 版本和其他正常 AP 版本，若版本不一致，升级到统一稳定版本。

## 四、Mac 终端侧测试（定位终端侧）

1. Mac 上：忽略此网络，重新连接；关闭「私有 Wi‑Fi 地址」（随机 MAC）测试；
2. Mac 系统更新到最新 macOS；
3. 把 Mac 放在该 AP 很近位置，排除信号衰减因素，看是否还掉线；

>
> 同位置 Windows 正常，Mac 异常，说明 Mac 网卡发射功率、空口协商对环境更敏感。

## 五、最简排障测试顺序（现场实操顺序）

1. 收集 AC 上 client history‑record 下线原因码；
2. 将 PMF 改为 optional；
3. 临时关闭该 AP radio 下 802.11k/v 做对比测试；
4. 关闭弱信号踢客户端；
5. 5G 射频改为 80MHz 频宽，更换信道；
6. 更换 AP 网线 / PoE 端口，排除有线侧；
7. 升级 AC、AP 固件版本到稳定版本。

## 补充判断点

- 如果关闭 11k/v 就恢复稳定：版本存在 11kv 兼容 bug，必须升级版本，不建议永久关闭漫游协议；
- 如果修改 PMF 为 optional 恢复：就是 PMF 强制模式和 macOS 兼容性问题；
- 如果下线记录显示大量重传超时：该点位空口干扰严重，需要调整信道、功率、AP 点位。

>