Cloud Run服务未读取请求体时遇1-10MB请求崩溃问题咨询

原因说明 #

Cloud Run的请求处理机制中，若服务未完整读取请求体就结束请求，底层网络代理会将此判定为异常情况，进而终止当前服务实例，最终返回通用500错误。这是因为代理需要确保请求体被正确处理，未读取完成的请求体被视为处理失败，触发了实例回收逻辑。

无需读取完整请求体返回413的实现方案 #

1. 通过请求头提前校验请求大小 #

在处理请求前，先检查Content-Length请求头判断请求体大小：

func handler(w http.ResponseWriter, r *http.Request) {
    maxAllowedSize := int64(10 * 1024 * 1024) // 限制为10MB
    if r.ContentLength > maxAllowedSize {
        w.WriteHeader(http.StatusRequestEntityTooLarge)
        _, _ = w.Write([]byte("请求体超过最大限制"))
        // 关键操作：必须关闭请求体，避免未读取导致的实例崩溃
        _ = r.Body.Close()
        return
    }
    // 后续正常业务逻辑
}

2. 用全局中间件统一拦截大请求 #

编写HTTP中间件，在所有请求处理前统一校验，同时覆盖分块编码（无Content-Length）的请求场景：

func maxBodySizeMiddleware(next http.Handler) http.Handler {
    return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
        maxSize := int64(10 * 1024 * 1024)
        // 处理带Content-Length的请求
        if r.ContentLength > maxSize {
            w.WriteHeader(http.StatusRequestEntityTooLarge)
            _, _ = w.Write([]byte("请求体超过最大限制"))
            _ = r.Body.Close()
            return
        }
        // 处理分块编码请求，设置读取上限
        r.Body = http.MaxBytesReader(w, r.Body, maxSize)
        next.ServeHTTP(w, r)
    })
}

http.MaxBytesReader会在请求体读取超过限制时自动抛出错误，避免服务实例因未读取完请求体而崩溃。

3. 前置负载均衡拦截（补充方案） #

可以在Cloud Run前配置Cloud Load Balancer，直接在负载均衡层设置请求体大小限制，超过限制时直接返回413，无需请求到达Cloud Run实例。

验证注意事项 #

• 无论采用哪种方案，都必须确保请求体被关闭或被限制读取，否则底层代理仍会判定请求处理异常。
• 针对分块编码的请求，仅通过Content-Length无法判断大小，必须使用http.MaxBytesReader做读取限制。

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