部署在Cloud Run的Nest.js API GET请求触发HTTP/2帧层流错误求助

• 强制客户端使用HTTP/1.1请求
  Cloud Run ingress默认支持HTTP/2，Insomnia可能自动用HTTP/2发起请求，即便你的Nest.js服务没开启HTTP/2。在Insomnia的请求设置里，把HTTP版本强制改成HTTP/1.1后重新测试GET请求，如果问题消失，说明是客户端与Cloud Run HTTP/2 ingress的兼容问题。

• 排查Nest.js GET端点的响应处理逻辑

  • 确认所有GET端点的响应都正确收尾：比如使用res.send()、res.json()返回数据时，确保Promise已正确resolve，没有代码分支导致响应未发送（比如未处理的异步错误）。
  • 临时禁用全局中间件/拦截器：比如日志、权限验证类的中间件，逐个恢复排查，看是否是某个中间件在处理GET响应时未正确关闭流，导致HTTP/2帧解析失败。
  • 检查异常过滤器：确认GET请求中的错误被正确捕获并返回标准响应，未捕获的异常可能导致服务端异常断开连接，触发流错误。

• 验证响应头的合法性
  用curl -v <你的GET端点URL>执行请求，查看响应头：

  • 检查Content-Length是否与响应体大小匹配，避免同时设置Transfer-Encoding: chunked和Content-Length，这会违反HTTP规范，导致HTTP/2帧解析错误。
  • 排查是否存在重复或非法的响应头字段，Cloud Run对HTTP头格式有严格校验，非法头会触发流层错误。

• 检查Cloud Run服务配置

  • 确认容器端口与Nest.js监听端口一致：Cloud Run默认容器端口是8080，确保你的Nest.js配置中listen的端口和这个设置匹配，端口不匹配可能导致请求异常。
  • 查看Cloud Run日志：过滤GET请求相关的日志，排查是否有服务端未捕获的异常、超时或资源不足的报错，这些都可能导致连接中断触发流错误。
  • 调整服务超时设置：如果GET请求处理逻辑耗时较长，默认超时（5分钟）可能不够，适当延长超时时间测试。

• 排查Google Bucket相关的GET逻辑

  • 确认Cloud Run服务账号权限：如果GET端点涉及从Google Bucket读取数据，确保服务账号拥有storage.objects.get或对应的列表权限，权限不足可能导致响应流异常中断。
  • 检查Bucket数据读取的流处理：如果是通过流返回Bucket文件内容，确保流被正确pipe到响应对象，且在流结束后正确调用res.end()，未正确关闭的流会导致HTTP/2帧错误。

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