Kratos框架微服务部署上线全流程教程-Golang-PHP中文网

Kratos服务上线需确保监听地址为0.0.0.0或:端口、健康探针路径严格匹配且HTTP接口可用、Helm配置中资源/端口/环境变量三项准确无误，缺一则触发CrashLoopBackOff或NotReady。

kratos框架微服务部署上线全流程教程

Kratos 服务上线不是“打包丢进 Kubernetes 就完事”，关键卡点在监听地址、健康探针、配置加载三处——错一个，CrashLoopBackOff 或 NotReady 立刻出现。

Kubernetes Pod 内部网络靠 ClusterIP Service 转发，容器进程若只监听 127.0.0.1:9000，Service 流量根本进不来，livenessProbe 直接失败。

http.Server 启动时地址必须是 ":8000" 或 "0.0.0.0:8000"，显式写 "127.0.0.1:8000" 会阻断所有外部访问
grpc.Server 同理，lis, _ := net.Listen("tcp", ":9000") 才安全；写成 "127.0.0.1:9000" 会导致 gRPC 客户端超时
本地开发用 127.0.0.1 没问题，但上线前必须改；建议统一用 ":${PORT}" + 环境变量驱动，避免硬编码

Kubernetes 的 readinessProbe 和 livenessProbe 默认走 HTTP GET，gRPC 原生不支持，直接配 httpGet.path: /healthz 会 404 或 503。

HTTP 服务：在 http.Server 路由里加一条 r.GET("/healthz", func(c *gin.Context) { c.NoContent(200) })（若用 Gin）或 Kratos 自带的 http.Handle("/healthz", http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) { w.WriteHeader(200) }))
gRPC 服务：不要试图让 httpGet 直连 gRPC 端口；要么暴露配套 HTTP 健康接口，要么用 grpc-health-probe 工具（需额外加 initContainer 下载二进制）
探针路径必须和 values.yaml 中 readinessProbe.httpGet.path 完全一致，大小写、斜杠都不能错；常见错误是写了 /health 但代码里注册的是 /healthz

Kratos 对资源、端口、环境变量极其敏感，模板里字段名或值写错，Deployment 创建后立刻 CrashLoopBackOff。

Kratos框架 2.8.2

Kratos框架 2.8.2 源码包下载，针对 Watch Resolver goroutine 测试及指标、日志默认值问题进行修正。

下载

resources.requests.memory 至少设为 128Mi；Kratos 启动时加载 gRPC 反射、中间件、日志组件会瞬时吃内存，64Mi 很容易触发 OOMKilled
service.port 和 deployment.container.ports.containerPort 必须严格一致；默认 HTTP 是 8000、gRPC 是 9000，改了任一端口就得同步改另一处，否则 Service 流量无法路由到容器
env.KRATOS_ENV 必须传入，比如 prod；Kratos 的 config.Load() 依赖它加载 configs/config.prod.yaml，漏掉就 panic：“failed to load config”

把数据库地址、Redis 地址、超时时间全写成 .Values.db.host、.Values.redis.port 这类键，维护成本爆炸，且和 Kratos 的多层配置优先级（环境变量 > ConfigMap > 默认值）冲突。

在 templates/configmap.yaml 里用 {{ .Values.config | nindent 2 }} 直接渲染整个 config.yaml 内容，格式保持 YAML 原样

values.yaml 里只保留顶层开关，比如

config: |<br>  server:<br>    http:<br>      addr: ":8000"<br>  data:<br>    database:<br>      source: ${DB_SOURCE}

敏感字段如密码，走 Secret 挂载，并在 config.yaml 中用 ${DB_PASSWORD} 占位，由 Kratos 的 env 解析器自动替换

真正难的不是写 Helm Chart，而是让 Kratos 进程在容器里“活下来”——它得能被探活、能读到配置、能扛住启动峰值内存。这三个条件缺一不可，任何一处松动，上线就是反复重启。