/healthz仅检查进程存活（accept、goroutine、内存），/readyz并发检查所有依赖并设超时；二者须独立ServeMux、禁用业务中间件、依赖失败记warn不打error、响应≤3秒、结构化日志精简、暴露Prometheus指标、内置指数退避自愈逻辑。

用 net/http 实现两个独立端点：/healthz 和 /readyz

必须拆开，不能共用一个 handler。Kubernetes 的 livenessProbe 和 readinessProbe 语义完全不同，混用会导致误杀——比如 DB 临时超时，/readyz 返回 503 是合理的，但若 /healthz 也查 DB，就会触发重启，加剧雪崩。

• /healthz 只检查进程是否卡死：比如 HTTP server 是否还在 accept 连接、关键 goroutine channel 是否阻塞、内存是否接近 OOM（可用 runtime.ReadMemStats 粗略判断）
• /readyz 才检查依赖：DB、Redis、下游 gRPC 服务等，任一失败就返回 http.StatusServiceUnavailable（503），且必须设超时
• 两个端点建议用独立的 http.ServeMux，和主业务路由隔离，防止业务 panic 或中间件崩溃导致健康探针失效

依赖检查必须带 context.WithTimeout，且并发执行

常见错误是串行调用 db.Ping() → redis.Ping() → client.CheckHealth()，一个慢就拖垮整个响应。生产环境要求 /readyz 响应 ≤ 3 秒，否则 K8s 会判定失败。

• 每个依赖检查函数都封装成 func() (string, error) 类型，例如 DBChecker(db *sql.DB) 内部调用 db.PingContext(ctx)，超时设为 500ms
• 用 errgroup.Group 并发执行所有 checker，避免单点延迟放大
• 不要在健康检查里做重操作：不刷新缓存、不重连连接池、不 reload 配置——它只反映「此刻是否可响应」，不是「是否完全就绪」

别在 handler 里打 error 日志，也别用 zap.Error 记依赖失败

健康检查被 K8s 每秒轮询多次，如果每次 DB 不通都打一条 error 日志，日志系统直接被刷爆。这不是 bug，是高频探测下的正常现象。

• 依赖失败统一记 warn 级，带上组件名和耗时，例如 zap.Warn("redis check failed", zap.String("component", "redis"), zap.Float64("latency_ms", 1200))
• 避免结构化日志字段过多（如把整个 error stack 写进日志），健康检查 handler 要轻量，CPU 和 GC 开销都要压到最低
• 如果用了 P

  

  rometheus，建议暴露 health_check_failed_total{component="mysql"} 这类指标，比日志更适合聚合分析抖动根因

恢复动作不能靠外部平台兜底，得在 Go 里主动做状态驱动协调

健康检查只是“感知”，真正的高可用在于“恢复”。K8s 重启容器是兜底手段，但代价高、有中断；Go 协程更适合做轻量、可控的自愈。

• 启动一个 goroutine 定期调 /readyz，连续 3 次失败就触发恢复：比如调 srv.Shutdown() 拒绝新请求、调 db.Close() + sql.Open() 重建连接、重新加载配置文件
• 对临时性错误（如网络抖动），用指数退避重试，而不是立即 panic —— backoff.Retry 或简单 for-loop + time.Sleep 就够用
• 若 5 分钟内重试 10 次仍失败，才 os.Exit(1)，把最终决策权交还给容器平台；这时退出是“优雅放弃”，不是“静默崩溃”

最常被忽略的一点：/healthz 和 /readyz 的响应体结构要一致，但语义必须严格分离——前者不许有任何外部 IO，后者必须覆盖所有流量路径依赖。写错一个超时或混用一个 handler，就可能让整套探针机制失效。

# mysql  # redis  # go  # golang  # ai  # 路由  # 配置文件  # kubernetes  # red  # sql  # 中间件  # String  # for  # 封装  # Error  # 并发  # channel  # http  # bug  # prometheus  # 重启  # 单点  # 重试  # 结构化  # 就会  # 还在  # 都要  # 设为  # 用了  # 这类 

相关栏目： 【 网站优化151355 】 【 网络推广146373 】 【 网络技术251813 】 【 AI营销90571 】

相关推荐： javascript基本数据类型及类型检测常用方法小结  Android 常见的图片加载框架详细介绍  在Oracle关闭情况下如何修改spfile的参数  JavaScript实现Fly Bird小游戏  javascript基于原型链的继承及call和apply函数用法分析  使用Dockerfile构建java web环境  Laravel怎么导出Excel文件_Laravel Excel插件使用教程  INTERNET浏览器怎样恢复关闭标签页_INTERNET浏览器标签恢复快捷键与方法【指南】  Java解压缩zip - 解压缩多个文件或文件夹实例  Laravel如何使用Facades（门面）及其工作原理_Laravel门面模式与底层机制  如何快速搭建自助建站会员专属系统？  Laravel Eloquent：优雅地将关联模型字段扁平化到主模型中  高防服务器租用首荐平台，企业级优惠套餐快速部署  如何在阿里云购买域名并搭建网站？  简单实现Android文件上传  如何做网站制作流程,*游戏网站怎么搭建？  Python3.6正式版新特性预览  Laravel怎么实现支付功能_Laravel集成支付宝微信支付  利用python获取某年中每个月的第一天和最后一天  Laravel怎么做缓存_Laravel Cache系统提升应用速度的策略与技巧  phpredis提高消息队列的实时性方法(推荐)  简历在线制作网站免费版,如何创建个人简历？  如何批量查询域名的建站时间记录？  Win11任务栏卡死怎么办 Windows11任务栏无反应解决方法【教程】  如何在橙子建站中快速调整背景颜色？  如何快速建站并高效导出源代码？  PythonWeb开发入门教程_Flask快速构建Web应用  Chrome浏览器标签页分组怎么用_谷歌浏览器整理标签页技巧【效率】  php在windows下怎么调试_phpwindows环境调试操作说明【操作】  Laravel怎么处理异常_Laravel自定义异常处理与错误页面教程  制作电商网页,电商供应链怎么做？  DeepSeek是免费使用的吗 DeepSeek收费模式与Pro版本功能详解  如何用狗爹虚拟主机快速搭建网站？  javascript事件捕获机制【深入分析IE和DOM中的事件模型】  湖南网站制作公司,湖南上善若水科技有限公司做什么的？  Laravel用户密码怎么加密_Laravel Hash门面使用教程  黑客如何利用漏洞与弱口令入侵网站服务器？  如何在Ubuntu系统下快速搭建WordPress个人网站？  C++时间戳转换成日期时间的步骤和示例代码  如何在IIS7上新建站点并设置安全权限？  Laravel如何配置中间件Middleware_Laravel自定义中间件拦截请求与权限校验【步骤】  如何在Windows虚拟主机上快速搭建网站？  如何用美橙互联一键搭建多站合一网站？  Laravel如何实现数据导出到PDF_Laravel使用snappy生成网页快照PDF【方案】  深圳防火门网站制作公司,深圳中天明防火门怎么编码？  Laravel事件监听器怎么写_Laravel Event和Listener使用教程  Laravel怎么自定义错误页面_Laravel修改404和500页面模板  Laravel如何安装Breeze扩展包_Laravel用户注册登录功能快速实现【流程】  成都网站制作公司哪家好,四川省职工服务网是做什么用？  laravel怎么配置和使用PHP-FPM来优化性能_laravel PHP-FPM配置与性能优化方法