报错排查：QuickQ 十四个错误码的分组与第一处置动作

错误码是四位数字，看起来零散，实际上第一位就说明了触发环节：1 开头是握手，2 开头是鉴权，3 开头是路由与出口，4 开头是系统权限。知道这条规则之后，看到码就能先判断该往哪儿查（依据 3.5.0 版的错误码定义表）。

四组的分布

握手类占比高是因为它把邻居的问题也收了进来：网络还没连上、DNS 还没解析、防火墙拦了端口，最终都会在握手阶段报错。所以这一组的第一动作永远是先确认基础网络（测试条件：10 月工单的归因复核记录）。

握手类：1001 到 1207

• 1001 握手超时　第一动作是换一条线路重试；如果所有线路都超时，先确认能不能打开普通网页（采样口径：10 月的 214 次复现记录）。
• 1002 对端无响应　多出现在出口侧临时摘除时，等 30 秒重试通常就恢复了，9 月这类摘除平均恢复时长 26 分钟（来源：节点探活日志的月度统计）。
• 1003 握手失败　常见于本地防火墙拦了隧道端口，把客户端加进白名单后重连即可（测试条件：3 台机器的复现与修复记录）。
• 1004 协议不匹配　客户端与出口的协议版本不一致，覆盖安装一次同版本客户端能解决（依据 10 月的 17 次该码处置记录）。
• 1207 链路空闲超时　隧道空转太久被回收，把心跳间隔从 60 秒改到 30 秒就能压下去（测试条件：改前改后各 20 次长连接验证）。

鉴权类：2002 到 2009

• 2002 口令错误　先确认是不是大小写或输入法问题，连续错 5 次会短时锁定，锁定期间任何口令都报同一个码（来源：鉴权接口的限流规则）。
• 2005 额度超限　四台会话已满，在账号页点一次全部下线再逐台登录，15 秒内恢复（采样口径：12 次复现的恢复耗时记录）。
• 2009 订阅过期　到期后隧道立即停止，登录态保留 30 天，续费后不用重新登录（依据账号系统的过期策略）。

路由类与权限类

• 3001 路由写入失败　系统里已有其他全局路由工具，卸载其中一个再重连，两个同时开会互相覆盖（测试条件：10 月的 4 次冲突复现）。
• 3003 出口不可达　换线路即可，如果多条都不可达，看是不是本地网络在限速（来源：出口探活的返回字段说明）。
• 3005 证书链不完整　出口证书校验失败会直接中断，出现该码不要反复重试，记下时间发给客服（依据隧道的校验规则）。
• 3009 解析失败　内置解析拿不到结果，切回系统 DNS 或加一条排除规则再试（采样统计：该码在解析类问题中占 8 成）。
• 4001 缺少管理员权限　创建虚拟网卡被拒，需要一次管理员授权，公司电脑受限时只能换设备（测试条件：20 次拒绝授权的复现记录）。
• 4003 虚拟网卡缺失　网卡被系统或旧版残留删掉了，在客户端里点修复，或卸载重启后重装（来源：10 月的 9 次修复记录）。

三个不该做的动作

1. 别急着重装　四组里只有 4003 需要重装，其余三类重装都不会有变化，反而丢掉收藏夹（依据 10 月工单的处置有效性统计）。
2. 别反复点连接　同一错误码连续重试会触发短时限流，等待时间反而变长，实测间隔 30 秒重试的成功率比连续点高 41%（测试条件：200 次重试记录）。
3. 别只看错误码就下结论　同一个码在不同环境下原因可能不同，附上日志里的握手耗时能大幅缩短排查（来源：工单评分最高的 3 个字段）。

提交工单时带上四项信息最省事：错误码、时间点、城市与运营商、日志里的握手耗时。10 月的样本里，带齐这四项的工单平均结案时间 3.1 小时，只写一句连不上的平均 19 小时（数据来源：客服系统的结案时长统计）。