Skip to main content

1 / 4概念

Lifecycle

读完能为一台 Go 服务定出可执行的超时与排空预算,判断一次发布为什么切断在途请求,并把健康检查、信号处理和 goroutine 退出顺序排对。Gin 与 Echo 只提供 handler,真正决定进程如何开始和结束的是 http.Server。

1 概念​

1.1 一句话定义​

服务生命周期指进程从读取配置、绑定端口、开始接收请求,到收到终止信号后停止接收、等待在途请求完成并退出的全过程。Gin 与 Echo 只提供 http.Handler,监听、超时、信号和排空由 net/http 的 http.Server 负责;框架的 Run 与 Start 只是薄封装。

1.2 它解决什么问题​

  • 连接可控:http.Server 的零值没有任何读写超时,慢连接可以长期占用文件描述符和 goroutine。
  • 发布不丢请求:进程收到 SIGTERM 后直接退出会切断在途请求,客户端看到连接重置或 502。
  • 摘流有顺序:负载均衡可能在进程退出后仍转发请求,需要先摘流再排空。
  • goroutine 有归属:handler 启动的 goroutine 如果使用 context.Background(),会在请求结束后继续运行并泄漏。
  • 探针可区分:健康检查与就绪检查混用,会让未完成初始化的实例提前接流量。

1.3 不属于本页的内容​

主题去哪
路由、参数、绑定与校验Routing and Binding
中间件顺序、恢复、鉴权、CORSMiddleware
goroutine、channel、context 取消Goroutines and Channels
容器、镜像、编排与探针Docker
指标、日志、追踪、熔断Fault Tolerance & Observability
构建标志、交叉编译、版本注入Go Toolchain

1.4 关键术语​

术语含义容易混淆的点
http.Server监听、连接、超时和排空的状态机不是框架的路由器
ListenAndServe创建 listener 并开始服务不能复用已有 listener
Serve在给定 listener 上服务适合 socket activation 与测试
Shutdown关闭 listener 和空闲连接,等待在途请求不等待 hijack 的连接
Close立即关闭 listener 和所有连接不保证在途请求完成
在途请求已接收但尚未写完响应的请求不是排队中的连接
keep-alive复用 TCP 连接处理多个请求不是长连接业务协议
排空窗口Shutdown 等待在途请求的时间上限不是请求超时
就绪检查实例是否可以接收流量不是存活检查