网络优化：从现有网络层出发

1. 背景与问题

交易 App 最容易出问题的场景不在办公室的 Wi-Fi 下，而在地铁、电梯、出门时 Wi-Fi 切到 4G 的那几秒。典型表现有三种：

1. 连接看起来还在，其实已经死了：行情不跳，下单没反应，界面却没有任何提示。
2. 请求叠在一起：网络恢复的瞬间，页面出现、重连成功、推送补发同时触发查询。
3. 超时和重试没有统一口径：有的请求等很久，有的立即失败，交易指令该不该重试也说不清。

这篇分两部分写。第 2、3 节只写项目里已经有的，每一条都能在代码里找到；第 4 到 8 节每节先写现状，再写建议，建议一律标为「建议（未做）」，不代表已经实现，也不写任何收益数字。

三条通道从同一套首版骨架起步，之后逐步加上重连节流、可达性处理和单飞。资金查询的合并窗口与强制通道、页面基类统一监听网络与网关状态也在这一层；前者在请求频率控制一篇里详写，长连接本身的建连与分发见两条长连接。

2. 项目里的网络层全景

3. 已有做法（逐项有证据）

3.1 三条通道各自管什么

3.2 网络变化之后发生了什么

3.3 合并：已经有三处

单飞的实现是一个以地址为键的「在途」字典：同一地址已有请求在途时，新的调用立即收到一个「请求中」的本地返回码。这类标志最怕提前返回时忘了复位，见第 9 节。

4. Wi-Fi 与 4G / 3G 切换

现状：只区分「状态变了」，任何变化都走「延迟检查 → 没连上才重连」。处理器里没有按接口类型（Wi-Fi / 蜂窝）分支，也没有读取蜂窝制式。

观察（从代码推断）：Wi-Fi 切到蜂窝时，旧的 TCP 连接可能处于半开状态，库仍然报告「已连接」，检查就会认为不用重连。交易侧收到心跳应答只是清零计数，没有用它判定连接已死，所以半开状态只能等库自己超时发现。

建议（未做）：

• 用 NWPathMonitor 监听路径变化，读取 usesInterfaceType、isExpensive、isConstrained。接口类型一变就主动重建两条长连接，而不是只看「是否已连接」。
• 用 CTTelephonyNetworkInfo 读取蜂窝制式，在 3G 下放宽超时、降低行情推送频率或缩小订阅范围。
• 用应用层心跳判定半开连接：连续若干次没收到心跳应答，就主动断开重连。

5. 请求合并

现状：见第 3.3 节。三处合并各自手写，「标记 + 延迟」的逻辑散在不同文件里。

建议（未做）：

• 抽一个通用合并器：键、窗口长度、首发还是尾发，标记用 defer 保证一定复位。
• 读请求按「方法 + 地址 + 参数」做签名，在途期间相同签名共享同一个结果，而不是像现在的单飞那样让后来者直接拿到「请求中」。
• 合并命中次数打点，按页面汇总，用来判断哪些触发源还在重复。

6. 请求头瘦身

现状：每个 HTTP 请求都带设备标识、语言，有条件地带广告标识，需要凭证的再加鉴权头。长连接只在握手时带一次。

建议（未做）：

• 设备标识、平台、版本这类静态字段，只在登录或握手时上报一次，由服务端绑定到会话上。
• 去掉业务不用的字段。
• 如果服务端支持 HTTP/2，重复的头部本身会被压缩，瘦身的收益要先量：用 URLSessionTaskMetrics 看请求头字节数，再决定值不值得改。

7. 响应压缩：gzip 与 Protobuf

现状：长连接是 Protobuf，并打开了 Socket.IO 的压缩选项；HTTP 是 JSON，依赖系统默认的压缩协商。仓库里没有 Protobuf 与 JSON 体积对比的材料，这里不写数字。

8. 弱网超时与重试

现状：HTTP 统一 15 秒，长任务 300 秒；交易指令不补发；行情登录在检查周期内没成功就再发一次，有上限；续期失败后的自动重试被删掉，等下一个触发点再续。

建议（未做）：

• 按接口类型分级超时：查询短、上传长、续期单独设置。
• 只对幂等的读请求做指数退避 + 随机抖动的重试，并设总时长上限；下单、撤单、改单这类交易指令绝不自动重试。
• 弱网时缩小行情订阅范围，只保留屏幕内的代码。
• 失败分类上报：DNS、建连、TLS、超时、服务端错误分开统计。

9. 踩过的坑

单飞标志泄漏。 持有者已释放时提前返回，没有复位在途标志，之后同一地址的请求都被当成「请求中」直接返回；修复是在这个分支里补上复位。任何「先置标志、异步后复位」的逻辑，都要检查所有提前返回的路径。它和续期的关系见凭证续期第 5 节。

重试要看触发点有多密。 续期失败后的自动重试已经删掉，改为等下一个触发点：续期的触发点本来就多，再叠加重试，弱网下会连续发出续期请求，见凭证续期第 5 节。第 8 节的退避重试建议因此只针对幂等读请求，并设总时长上限。

交易指令不能「贴心」地补发。 网络恢复后自动补发下单，价格和用户的意图可能都已经变了；项目里交易指令在未连接时直接丢弃，由上层按失败处理，见两条长连接第 4.4 节。

10. 对比与取舍