511 是什么
511 Network Authentication Required 用来告诉客户端：网络本身需要先通过认证才能上网。酒店、机场、园区网的强制门户就是靠它提示登录页。客户端系统与浏览器通过这个状态码判断自己处在受控网络里，从而自动弹出认证页面；响应里还可以带链接指向门户地址，方便程序直接跳转。规范定义在 RFC 6585 第 6 节。
基本信息
| 状态码 | 511 Network Authentication Required |
|---|---|
| 语义 | 需要先完成网络层认证 |
| 规范 | RFC 6585 §6 |
| 典型场景 | 酒店、机场、园区网的强制门户 |
| 配套内容 | 响应可带指向认证页面的链接 |
| 与 403 区别 | 403 是资源级禁止访问，511 是网络准入问题 |
探测强制门户
探测强制门户
curl -si http://connectivitycheck.gstatic.com/generate_204 | head -5
# 正常应回 204 No Content；被门户劫持时常见 302 或 511
curl -si https://www.example.com/ | head -3 # 观察是否被重定向到门户地址门户场景下的常见响应
| 现象 | 含义 | 处理方式 |
|---|---|---|
| 返回 204 | 网络通畅，无门户拦截 | 正常访问 |
| 返回 302 跳转 | 被门户重定向到认证页 | 完成认证后再访问 |
| 返回 511 | 需完成网络认证 | 打开认证页面 |
| DNS 解析被劫持 | 所有域名都指向同一地址 | 先完成认证再排查其他问题 |
典型使用场景
- 公共 WiFi 认证异常排查：确认是门户未弹出还是认证后未放行
- 客户端连通性检测设计：用固定地址与预期响应码判断当前网络状态
- 移动应用网络切换：识别需要认证的网络，提示用户手动登录
- 企业访客网络部署：设计门户拦截与放行策略时明确响应行为
- 自动化设备入网：脚本里识别 511 并给出明确的告警而非无限重试
系统与浏览器把 511 与特定的连通性探测地址结合起来判断网络状态，因此探测地址被解析成异常结果时，客户端可能判定「网络不可用」而拒绝联网。排查公共 WiFi 问题时，先看探测请求实际收到了什么响应，再判断是门户行为还是客户端策略问题。