酒店WiFi认证系统上线之后，运维的工作量比大多数IT系统大——客人对网络敏感、场景多样、设备类型杂，出了问题投诉会直接到前台和店长。工程商运维团队积累一套自己的故障处理手册非常有必要。这篇文章整理的是实际项目里最常碰到的几类故障，以及对应的排查思路。

第一类故障：客人连不上WiFi，搜不到SSID。这种情况先做几个快速判断：AP是否上电（看指示灯）、网线是否通畅（用测线仪）、交换机端口是否正常（看端口指示灯和VLAN配置）、AP是否被AC纳管（看AC管理界面）。如果都正常，客人那边的问题可能是设备WiFi开关没开、飞行模式没关、或者设备本身WiFi模块损坏——这种就只能让客人换设备试试了。另一种少见情况是AP的SSID广播被误关闭或者功率被调到最低，登录AC后台就能看到。

第二类故障：客人搜到SSID但连不上，认证页弹不出来。这种情况一般是三层通信问题。先看客人的IP分配情况——如果拿不到IP，是DHCP池耗尽或者DHCP snooping配置错误；如果拿到了IP但打不开Portal页，是DNS解析失败或者Portal重定向没配好。快速验证方法是让客人用手机4G访问一个域名（比如baidu.com），如果4G正常就排除了客人侧的问题。

第三类故障：Portal页能弹但输入手机号收不到验证码。短信认证链路涉及三个环节：Portal页提交手机号 → WiFi系统转发到短信网关 → 短信网关下发到客人手机。任何一个环节出问题都会导致收不到验证码。排查时先看WiFi系统日志里有没有"短信发送成功"的记录；如果有但客人没收到，多半是短信通道问题（通道欠费、被运营商屏蔽、签名没报备）；如果没有发送记录，看Portal页提交的API请求是否到达WiFi系统后台。这种情况十有八九是短信通道欠费或者API对接异常。

第四类故障：客人能上网但速度很慢。这种问题最难排查，因为涉及环节多。先做带宽测试——从核心交换机直接接笔记本测速，看外网带宽是否正常；正常的话再测客房网线速率——客房面板到交换机的链路是否协商到千兆；正常的话再看AP下挂的终端数——一个AP下挂40台终端和挂10台终端，速率差距很大。最后看限速策略是否生效——有的酒店误把限速配置成"每终端1M"，高峰期客人自然觉得慢。

第五类故障：客人上网过程中频繁掉线。这种一般是漫游问题——客人在房间里移动，从一个AP的覆盖范围走到另一个AP，切换不及时导致短暂断网。技术上要求AP的信号覆盖有10%-15%的重叠区，同时支持802.11k/v/r快速漫游协议。如果厂商系统不支持这套协议，临时解决方案是把AP的发射功率降低、让重叠区缩小，强制终端更早切换AP。

第六类故障：会议厅/宴会厅瞬时高并发卡顿。这种通常是AP数量不够或者信道规划不合理。临时应急是减少AP的发射功率（让客人均匀分布到不同AP上）、限制单终端最大速率（避免个别设备占满带宽）、关闭2.4G频段只保留5G（5G信道多干扰少）。长期方案还是要做专业的勘测和规划。

第七类故障：日志系统满导致认证失败。WiFi认证系统产生的日志量很大——每分钟几十条到几百条都有。如果日志清理策略没配好，磁盘写满后系统会卡死，认证也跟着卡。定期巡检磁盘空间、配置日志自动清理（保留6个月合规最低时长）、监控磁盘使用率是必要的运维动作。

故障处理的核心是分层排查——物理层、网络层、认证层、应用层逐级判断，不要一上来就改配置。每种故障积累一份SOP（标准操作流程），运维团队人手一份，处理效率会高很多。酒店WiFi出问题不能等——客人等5分钟就要换酒店，工程商必须能在15分钟内给到临时方案，1小时内给到根因结论。