go语言不实现微服务自动扩缩容，仅确保服务可被扩缩容；真正决策由kubernetes hpa等完成，go需暴露合规/healthz、/ready端点，规范/metrics指标，实现优雅退出，并正确配置hpa。
Go 语言本身不实现微服务自动扩缩容——它只负责让服务“可被扩缩容”。真正的扩缩容决策和执行，由 Kubernetes HPA、云厂商弹性组或自建控制器完成。你在 Go 里要做的，是堵住所有会让扩缩容失效的漏洞。
暴露 /healthz 和 /ready 端点必须轻量且语义清晰
这两个端点不是摆设，Kubernetes 的 livenessProbe 和 readinessProbe 会高频调用它们。一旦返回错误或超时，Pod 就会被重启或摘流。
-
/healthz只检查进程是否存活：能响应 HTTP、goroutine 调度正常、无 panic 堆栈泄漏。不要查 DB、Redis 或远程 API -
/ready必须检查关键依赖：DB 连接池db.PingContext()、配置加载完成、gRPC client 已连接。建议加context.WithTimeout(r.Context(), 2*time.Second) - 别复用同一个 handler 处理两者——
/healthz不能因 DB 暂时不可用就失败，否则 HPA 误判为实例崩溃，触发不必要的滚动重启 - 返回状态码必须是
http.StatusOK（200），不能是 204 或 304；body 内容无关紧要，但别返回大 JSON
/metrics 端点必须严格符合 Prometheus 规范
HPA 使用 custom metrics 时，不直接抓你的 /metrics，而是通过 prometheus-adapter 查询 Prometheus。你的指标若格式不对，整条链路就断了。
- 必须用
promhttp.Handler()注册，路径只能是/metrics，不能是/actuator/prometheus或/debug/metrics - 指标名只能含小写字母、数字、下划线：
http_requests_total✅，HttpRequestsTotal❌，http-requests-total❌ - 延迟类指标必须是
Histogram类型，用prometheus.NewHistogramVec()构建；HPA 不接受客户端预计算的 P95，必须靠 Prometheus 的histogram_quantile(0.95, ...)聚合 - 每个指标必须带
namespace和pod标签，例如：http_requests_total{namespace="prod",pod="user-svc-5f8d4b9c-xvq9t"}；否则prometheus-adapter无法按 Pod 维度聚合，HPA 查不到单实例指标
优雅退出必须覆盖所有长生命周期资源
Kubernetes 缩容时发 SIGTERM，默认等待 30 秒（terminationGracePeriodSeconds）后强杀。Go 程序若没处理，正在写的数据库事务、未 ack 的 Kafka 消息、未 flush 的日志都会丢。
- 主 goroutine 启动后，立即监听
syscall.SIGTERM和syscall.SIGINT，**不能只监听 os.Interrupt**（K8s 不发这个） -
http.Server.Shutdown()是起点，不是终点：调用前先关闭 gRPC server、取消 background ticker、显式调用db.Close()、redis.Close()、kafkaConsumer.Close() -
srv.SetKeepAlivesEnabled(false)要在Shutdown()前设置，防止新连接在关闭窗口内接入 - context 超时时间（如 10 秒）必须 ≤ YAML 中的
terminationGracePeriodSeconds，否则系统会在你 cleanup 完成前发SIGKILL
HPA YAML 配置错一个字段，指标就“看不见”
kubectl get hpa 显示 Unknown 或 No metrics，90% 不是 Go 代码问题，而是 HPA 配置与 Prometheus adapter rules 不匹配。
-
scaleTargetRef.name必须和 Deployment 的metadata.name**完全一致**（区分大小写），不能填 Service 名或 Pod 名 - 若用 Pod 级别指标（最常见），
metrics[].type填Pods，metrics[].pods.metric.name填的是 adapter rules 里定义的 name（如http_requests_per_second），不是原始指标名（如http_requests_total） -
target.type: AverageValue时，target.averageValue必须是带单位字符串："100m"（表示每秒 0.1 次请求），不能写100或"100" - 用
type: Object（如按 Deployment 总 QPS 扩容）时，describedObject.kind必须是Deployment，且metric.selector必须匹配 adapter 中resources字段定义的 label selector
最容易被忽略的点：HPA 不看单个实例的绝对 CPU，而是看 requests 的利用率百分比。如果你的 Deployment 没设 resources.requests，HPA 会拒绝扩容，且不报错——它就静默跳过。这个字段不是可选的，是硬门槛。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
