kratos run不能用于生产,因其本质是go run封装,未打包依赖、未注入配置、无优雅停机、无健康检查、日志不采集,不满足K8s生命周期要求。

kratos run不是生产部署命令,它只适用于本地开发调试。真正上线必须用构建后的二进制或容器镜像,否则会因依赖未打包、配置未注入、信号处理缺失等问题直接崩溃。
为什么 kratos run 不能上生产
该命令本质是 go run 封装:它动态加载源码、读取本地 configs/config.yaml、跳过编译优化、忽略进程守护。常见故障包括:
-
panic: config not found—— 生产环境不会保留configs/目录,且配置通常来自环境变量或远程配置中心 - 收到
SIGTERM后立即退出,无优雅停机(如等待 gRPC 连接关闭、HTTP 请求完成) - 日志输出到终端而非文件,无法被日志采集系统(如 Loki、Filebeat)捕获
- 没有资源限制、健康检查端点、启动超时控制,不满足 Kubernetes Pod 生命周期要求
make build 生成可部署二进制的要点
Kratos 模板自带 Makefile,但默认 make build 生成的是调试版二进制。生产部署需额外控制:
- 使用
CGO_ENABLED=0 GOOS=linux go build生成静态链接二进制,避免容器内缺失 libc - 通过
-ldflags "-s -w"剥离符号表和调试信息,体积减少 30%~50% - 在
main.go中显式传入kratos.WithName("your-service"),确保服务注册名与配置一致 - 确认
cmd/server/main.go中的kratos.New(...)已注入kratos.Registrar(...)和kratos.Server(...),否则服务不会向注册中心上报
容器化部署时配置注入的三种方式
不能把 config.yaml 打进镜像,必须运行时注入。Kratos 支持多源配置合并,优先级从高到低为:
- 环境变量(如
DATA_DATABASE_HOST=10.0.1.5)→ 自动映射到conf.Data.Database.Host - 命令行参数(
--conf.path /etc/config.yaml)→ 需提前挂载 ConfigMap 或 Secret - 远端配置中心(Nacos/Consul)→ 必须在
internal/conf/conf.go中启用对应驱动,并设置CONF_PROVIDER=nacos
注意:env: 前缀在 YAML 中需显式声明,例如 server: 下写 port: ${PORT:9000} 才能 fallback 到环境变量 PORT。
Kubernetes 部署必须补全的健康检查项
Kratos 默认不暴露 /healthz 端点,需手动注册 HTTP handler。否则 K8s livenessProbe 会误杀存活服务:
// 在 internal/server/http.go 的 NewHTTPServer 中添加
mux.Handle("/healthz", http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
w.WriteHeader(http.StatusOK)
w.Write([]byte("ok"))
}))
-
readinessProbe应检查数据库连接、下游服务连通性等业务就绪状态,不能只依赖 HTTP 200 -
terminationGracePeriodSeconds至少设为 30,给kratos.App.Stop()留出足够时间 - gRPC 服务需额外暴露
/readyz并集成grpc_health_v1,否则 Istio 等服务网格无法感知状态
真实部署中最容易被忽略的是信号处理链路完整性——从容器 SIGTERM → 进程接收 → kratos.App.Stop() → 各 transport server 关闭 → registry deregister,任一环断裂都会导致服务“假死”:注册中心还显示在线,但新请求已无法进入。务必在预发环境用 kill -15 实测整条链路。











