如何解决向99designs/gqlgen后端上传大文件时的连接重置问题？

1. 调整HTTP服务器的请求大小限制 #

大部分HTTP框架（包括标准库net/http）默认有请求体大小限制（比如net/http默认约10MB），直接上传500MB文件肯定会触发限制导致连接重置。你需要手动设置更大的阈值：

如果用标准库net/http：

http.HandleFunc("/graphql", func(w http.ResponseWriter, r *http.Request) {
    // 设为600MB，比目标文件大小留些冗余
    r.Body = http.MaxBytesReader(w, r.Body, 600*1024*1024)
    // 继续处理gqlgen请求
    handler.ServeHTTP(w, r)
})

如果是Gin框架集成gqlgen：

router.POST("/graphql", func(c *gin.Context) {
    c.Request.Body = http.MaxBytesReader(c.Writer, c.Request.Body, 600*1024*1024)
    handler.ServeHTTP(c.Writer, c.Request)
})

2. 自定义gqlgen的Multipart传输配置 #

gqlgen自带的Multipart传输组件也有默认大小限制，需要在初始化服务器时手动调整：

import (
    "github.com/99designs/gqlgen/graphql/handler"
    "github.com/99designs/gqlgen/graphql/handler/transport"
)

func main() {
    srv := handler.NewDefaultServer(generated.NewExecutableSchema(generated.Config{Resolvers: &resolvers{}}))
    
    srv.AddTransport(&transport.Multipart{
        // 内存阈值：超过这个大小的文件块会写入临时文件，建议设为64MB
        MaxMemory: 64 * 1024 * 1024,
        // 允许的总上传大小，设为600MB
        MaxUploadSize: 600 * 1024 * 1024,
    })
    
    // 启动服务器逻辑...
}

3. 延长服务器超时时间 #

大文件上传耗时久，默认的读写超时可能导致连接被提前切断，调整HTTP服务器的超时参数：

import "time"

srv := &http.Server{
    Addr:         ":8080",
    Handler:      srv, // 这里传入你的gqlgen handler
    ReadTimeout:  30 * time.Minute, // 根据实际上传速度调整，留足冗余
    WriteTimeout: 30 * time.Minute,
    IdleTimeout:  1 * time.Hour,
}
srv.ListenAndServe()

4. 优化临时文件存储（可选） #

如果担心系统临时盘空间不足，可以指定自定义临时目录存储大文件的临时块：

srv.AddTransport(&transport.Multipart{
    MaxMemory:     64 * 1024 * 1024,
    MaxUploadSize: 600 * 1024 * 1024,
    TempFileDir:   "/data/temp/uploads", // 替换成你的可用目录
})

5. 检查反向代理/负载均衡的限制 #

如果后端前面有Nginx这类代理，也要同步调整其配置：

server {
    # 允许的最大请求体大小
    client_max_body_size 600M;
    # 延长代理超时时间
    proxy_read_timeout 30m;
    proxy_connect_timeout 30m;
    proxy_send_timeout 30m;
}

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