Swift gRPC客户端崩溃后所有客户端无法连接Tonic服务端如何解决

1. 调整tonic服务端HTTP/2与TCP连接配置 #

你遇到的所有客户端连接被重置的核心原因大概率是Swift客户端异常崩溃时未发送正常的HTTP/2断开帧，导致服务端h2状态机进入异常，或残留的半开连接耗尽了服务端的连接/流配额，优先调整以下tonic配置：

• 开启传输层TCP保活，替代仅应用层的http2 keepalive，同时配置异常连接自动回收逻辑，示例配置：

use std::time::Duration;
use tonic::transport::Server;

let server = Server::builder()
    // TCP层保活配置，30秒无流量就发送探测包
    .tcp_keepalive(Some(Duration::from_secs(30)))
    // 单连接最大并发流数，避免异常连接占用过多流资源
    .max_concurrent_streams(Some(128))
    // 待重置流的最大缓存数，避免异常流累计触发h2保护
    .http2_max_pending_accept_reset_streams(Some(1024))
    // 连接超时，无活跃请求的连接60秒自动断开
    .timeout(Duration::from_secs(60))
    .add_service(your_service)
    .serve(addr);

• 如果你使用的tonic版本低于0.9，建议升级到最新稳定版，旧版本依赖的hyper/h2库存在已知的h2状态机异常bug，收到非法帧后会导致全局连接处理逻辑卡住，所有新请求都会被重置。

2. 验证半开连接残留问题 #

复现问题后在服务端执行以下命令检查TCP连接状态：
ss -tulnp | grep 你的服务端端口
如果存在大量来自崩溃的Swift客户端IP的ESTABLISHED状态连接，说明半开连接未被正常回收，可配合调整服务端所在操作系统的TCP参数：

• Linux环境下开启net.ipv4.tcp_tw_reuse = 1、net.ipv4.tcp_fin_timeout = 10加速异常连接回收

3. 补充Swift客户端崩溃时的资源清理逻辑 #

在Swift客户端增加崩溃信号捕获钩子，捕获到SIGSEGV、SIGABRT等崩溃信号时，主动调用gRPC通道的shutdown()方法，主动向服务端发送GOAWAY帧通知服务端回收连接，避免残留异常状态。

4. 日志排查定位根因 #

开启tonic服务端的trace级别日志，复现问题时查看崩溃触发瞬间服务端收到的HTTP/2帧内容，可确认是否是Swift客户端崩溃时发送了畸形帧触发了服务端的h2协议错误保护逻辑。

内容的提问来源于stack exchange，提问作者Timmy