# 排错指南概述

WiFi 网络问题可能由多种因素引起——从物理层的信号干扰到 MAC 层的协议错误，再到上层的应用配置。系统化的故障排除方法可以快速定位和解决问题。

## WiFi 故障分类

```
WiFi 问题树:

1. 无法连接
   ├── 密码/认证错误
   ├── SSID 不可见（隐藏或信道不支持）
   ├── 驱动/固件兼容性问题
   └── 硬件故障

2. 连接不稳定
   ├── 信号弱（距离远/障碍物多）
   ├── 同频干扰（邻居 WiFi）
   ├── 非 WiFi 干扰（微波炉/蓝牙）
   ├── DFS 信道切换
   └── 过载（AP 容量不足）

3. 速率低
   ├── 退回到低速模式（信号差）
   ├── 2.4 GHz 频段拥塞
   ├── 单空间流设备
   ├── 窄信道宽度
   └── AP 后端带宽瓶颈

4. 高延迟/抖动
   ├── 无线介质竞争
   ├── QoS 未配置
   ├── 漫游切换慢
   └── 有线回程拥塞
```

## 系统化排错方法

### OSI 分层排查法

```
Layer 1 (物理层):
□ 信号强度足够？(RSSI > -70 dBm)
□ 信噪比良好？(SNR > 20 dB)
□ 信道干扰低？(使用频谱分析仪检查)
□ 天线连接正常？

Layer 2 (数据链路层):
□ MAC 地址正确？
□ 认证通过？(查看系统日志)
□ IP 获取成功？(DHCP)
□ VLAN 配置正确？

Layer 3 (网络层):
□ 路由可达？(ping 测试)
□ DNS 解析正常？
□ 防火墙规则未阻止？

Layer 4+ (传输/应用层):
□ 端口开放？
□ 应用配置正确？
□ QoS 策略生效？
```

## 关键指标参考值

| 指标 | 优秀 | 良好 | 可接受 | 差 |
|------|------|------|--------|-----|
| RSSI | > -50 dBm | -50 ~ -60 | -60 ~ -70 | < -70 |
| SNR | > 25 dB | 20-25 | 15-20 | < 15 |
| 重传率 | < 1% | 1-3% | 3-8% | > 8% |
| 信道利用率 | < 40% | 40-60% | 60-80% | > 80% |

```{toctree}
:maxdepth: 2
:hidden:

interference
optimization
tools
```