Go服务必须暴露符合Prometheus文本协议的/metrics端点，使用promhttp.Handler()注册，指标名仅含小写字母、数字、下划线，自定义指标用GaugeVec；HPA需通过prometheus-adapter转换并配置正确rules，延迟指标须用histogram_quantile预计算，同时做好限流、预热、优雅退出及健康检查隔离。
Go服务必须暴露/metrics且格式严格符合Prometheus文本协议
HPA读不到指标，90%是因为/metrics端点没暴露、路径不对，或返回内容不符合规范。Kubernetes默认只抓/metrics，不是/actuator/prometheus或/debug/metrics；也不能用expvar或手写JSON响应——HPA不解析JSON，只认Prometheus原生文本格式。
- 必须用
promhttp.Handler()注册到/metrics，不要加JWT中间件、gzip压缩或任何拦截逻辑 - 指标名只能含小写字母、数字、下划线：
http_requests_total✅，http-requests-total❌ - 自定义指标推荐用
prometheus.NewGaugeVec()，HPA不支持CounterVec的瞬时值比较 - 若用
prometheus.DefaultRegisterer，注意v1.16+版本Register()可能panic，改用MustRegister()
HPA无法直接读取Go暴露的原始指标，必须经prometheus-adapter转换
metrics-server只提供CPU和内存指标；QPS、P95延迟等自定义指标要进HPA，必须部署prometheus-adapter，并配置rules把Prometheus时间序列映射成HPA能识别的Service或Pod级指标。
- rules中
seriesQuery必须精确匹配job和instance标签，漏写{job="my-go-svc"}会导致Adapter查不到数据 -
resources字段要设对：按Pod伸缩就写overrides: {pod: {resource: "pods"}}，按Service伸缩才用name: {resource: "services"} - 延迟类指标（如
http_request_duration_seconds_bucket）必须在PromQL里用histogram_quantile(0.95, ...)算好，HPA不支持客户端聚合 - 验证是否生效：执行
curl http://<k8s-apiserver>/apis/custom.metrics.k8s.io/v1beta2/namespaces/default/services/my-go-svc/go_http_request_duration_seconds_p95</k8s-apiserver>，应返回数值而非404或空数组
Go服务内部需预热与限流，不能只依赖HPA响应
从HPA检测到指标超阈值，到新Pod Ready并接入流量，通常耗时30–90秒。这期间未被拦截的突发请求会压垮存量实例，导致雪崩。
Golang Spf13 Viper
下载
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
- 在HTTP handler前加轻量级限流器（如
golang.org/x/time/rate.Limiter），按每秒请求数硬限制 - 启动时预热关键依赖：连接池warmup、缓存预加载、gRPC连接建立，避免新Pod上线后因冷启动抖动失败
- 避免在
/healthz里检查DB/Redis——HPA探针失败会触发重启循环，反而加剧不稳定 - 所有指标采集逻辑必须异步非阻塞，别让
/metrics响应卡住主线程
缩容时goroutine不是扩容单元，优雅退出才是关键
常见误区是想在Go代码里“动态起goroutine”模拟扩容，这是无效的：HPA扩的是Pod（进程），不是协程。goroutine再多，单个Pod仍受限于CPU request，且无法分摊到不同节点。
立即学习“go语言免费学习笔记（深入）”；
- 缩容靠Kubernetes发
SIGTERM，Go程序必须监听并调用http.Server.Shutdown()，带context timeout等待活跃请求结束 - Shutdown前要关闭数据库连接池、消息消费者、长连接客户端等资源，否则Shutdown可能阻塞超时
- 反向代理（如Envoy）需配置
/healthz健康检查，并设置足够短的探测间隔（如5s）和失败阈值（如2次失败即摘流） - terminationGracePeriodSeconds建议设为45s以上，给Shutdown留足时间，尤其当有长尾请求或大文件上传时
http_requests_total如果混入了健康检查请求，HPA就会把探针流量当成真实业务负载，导致误扩。这点容易被忽略，但直接影响伸缩准确性。 
