Tomcat HTTP2中WINDOW_UPDATE帧未作用对应流导致超时问题

问题场景 #

• 开发基于TLS 1.3和HTTP/2的客户端应用，当接收窗口大小大于响应大小时运行正常
• 将接收窗口设为65536后，若窗口小于响应大小，客户端发送WINDOW_UPDATE帧，Tomcat日志显示该帧已被处理，但仍抛出超时异常

报错信息 #

org.apache.coyote.CloseNowException: org.apache.coyote.http2.StreamException: Timeout waiting for client to increase flow control window to permit stream data to be written

Tomcat配置（TLS1.3 + HTTP/2） #

<Connector port="443" protocol="org.apache.coyote.http11.Http11AprProtocol"
           maxThreads="150" SSLEnabled="true" useIPVHosts="true" resolveHosts="true" address="0.0.0.0">
    <UpgradeProtocol className="org.apache.coyote.http2.Http2Protocol"/>
    <SSLHostConfig>
        <Certificate certificateKeyFile="C:/Users/Testenv/Desktop/Certs/server.key"
                     certificateFile="C:/Users/Testenv/Desktop/Certs/server.crt"
                     type="RSA" />
    </SSLHostConfig>
</Connector>

关键日志分析 #

从Tomcat日志可明确看出核心矛盾：

• 服务器在等待**流[1]**的流控窗口释放，以继续发送数据
• 客户端发送的是**流[0]（连接级）**的WINDOW_UPDATE帧，仅更新了连接级总窗口，未更新流[1]的独立窗口

09-Jun-2023 15:56:42.916 FINE [https-openssl-apr-0.0.0.0-443-exec-3] org.apache.coyote.http2.WindowAllocationManager.waitForStream Connection [0], Stream [1], Waiting for Stream flow control window (blocking) with timeout [20000]
09-Jun-2023 15:56:43.013 FINE [https-openssl-apr-0.0.0.0-443-exec-4] org.apache.coyote.http2.Http2Parser.readWindowUpdateFrame Connection [0], Stream [0], Window size increment [32768]
09-Jun-2023 15:56:43.013 FINE [https-openssl-apr-0.0.0.0-443-exec-4] org.apache.coyote.http2.AbstractStream.incrementWindowSize Connection [0], Stream [0], increase flow control window by [32768] to [32768]
09-Jun-2023 15:57:09.119 FINE [https-openssl-apr-0.0.0.0-443-exec-3] org.apache.coyote.AbstractProcessor.setErrorState Error state [CLOSE_NOW] reported while processing request
        org.apache.coyote.CloseNowException: org.apache.coyote.http2.StreamException: Timeout waiting for client to increase flow control window to permit stream data to be written

原因分析 #

HTTP/2的流控机制分为连接级和流级两个独立的窗口：

1. 连接级窗口（流ID=0）控制整个HTTP/2连接的总数据发送量
2. 流级窗口（每个独立请求流对应唯一ID）控制单个请求流的数据发送量
   服务器当前阻塞在流[1]的流级窗口耗尽，但客户端仅更新了连接级窗口，流[1]的窗口仍处于无法发送数据的状态，最终触发超时。

解决方法 #

1. 发送对应流的WINDOW_UPDATE帧：当流[1]的窗口耗尽时，客户端需要构造并发送流ID=1的WINDOW_UPDATE帧，而非流ID=0的连接级帧
2. 校验帧的流ID逻辑：检查客户端代码中生成WINDOW_UPDATE帧的逻辑，确保流ID与当前请求的目标流完全匹配
3. 可选：调整初始窗口大小：若需临时缓解，可在Tomcat的Http2Protocol配置中调整流级初始窗口（默认65536），配置示例：

   <UpgradeProtocol className="org.apache.coyote.http2.Http2Protocol">
       <Parameter name="initialWindowSize" value="131072"/>
   </UpgradeProtocol>
   

   注：此方法仅为临时优化，根本解决仍需确保客户端发送正确的流级窗口更新帧

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