Fiber框架需手动实现健康检查接口，推荐分设/health/live和/health/ready端点：前者仅检查进程存活、goroutine数等本地状态，响应≤1秒；后者并行探测DB、Redis等依赖并缓存结果，失败返回503。
Fiber 本身不内置微服务健康检查逻辑，它只是一个高性能 Go Web 框架；健康检查路由是否生效、是否被注册中心识别，取决于你怎么暴露它，以及Nacos / Consul 等注册中心如何探测它。直接配一个 /health 路由远远不够。
Fiber 中定义健康检查路由必须返回 200 且响应体可预测
Nacos（默认）对临时实例做 TCP 或 HTTP 健康检查，HTTP 模式下会向你配置的 health-check-path 发起 GET 请求，并期望返回 HTTP 200 + 可读响应（如 {"status":"UP"}）。
如果你只写 app.Get("/health", func(c *fiber.Ctx) error { return c.SendString("ok") })，多数注册中心能过，但存在隐患：
- Nacos 默认用
<a href="https://www.php.cn/link/66d3ff8688d3f6f00f97949d0bc22a86">https://www.php.cn/link/66d3ff8688d3f6f00f97949d0bc22a86</a>（Spring Boot 风格），不是/health—— 你要显式对齐 - 响应体含不可控字段（如时间戳、随机 ID）会导致某些注册中心误判为“不稳定”
- 没加
Content-Type: application/json，部分严格客户端可能拒绝解析
推荐写法：
app.Get("/health", func(c *fiber.Ctx) error {
c.Set("Content-Type", "application/json")
return c.JSON(fiber.Map{
"status": "UP",
"timestamp": time.Now().UnixMilli(),
})
})⚠️ 注意：别在健康检查里查数据库或调远程服务——它必须是轻量、无副作用、毫秒级返回的。
Nacos 客户端注册时必须显式传入 healthCheckPath 和 healthCheckInterval
Fiber 应用要被 Nacos 当作“支持 HTTP 健康检查的服务”，不能只靠路由存在，还必须在注册实例时把健康检查元数据带上。
Spring Cloud Alibaba 是自动注入的，但纯 Go 的 go-nacos 或 nacos-sdk-go 不会自动读取你的路由配置。
你得手动构造 Instance 并设置：
-
HealthCheckPath: 必须和上面定义的路由路径一致（如/health） -
HealthCheckInterval: 单位是毫秒，建议设为5000（对应 Nacos 的heart-beat-interval: 5000） -
Metadata中可加"preserved.heart.beat.timeout"和"preserved.ip.delete.timeout"，否则 Nacos 用默认值（15s / 30s），容易误剔
示例关键代码（使用 nacos-sdk-go）：
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
instance := model.Instance{
Ip: "192.168.1.100",
Port: 8080,
ServiceName: "user-service",
Weight: 1.0,
Enable: true,
Healthy: true,
Ephemeral: true,
HealthCheckPath: "/health",
HealthCheckInterval: 5000,
Metadata: map[string]string{
"preserved.heart.beat.timeout": "15000",
"preserved.ip.delete.timeout": "30000",
},
}漏掉 HealthCheckPath，Nacos 就只会做 TCP 连通性检查（只看端口是否 open），无法感知应用内部状态。
多实例部署时，每个节点的健康检查必须独立生效
常见错误是所有实例共用同一个 /health 路由，但返回内容依赖全局变量（如共享的连接池状态、缓存命中率），导致一个节点挂了，其他节点的健康检查也跟着失败。
你应该让每个实例的健康检查只反映本机状态：
- 检查本地 HTTP server 是否还在 accept 连接（可用
net.Listener.Addr()辅助判断） - 检查本地关键 goroutine 是否存活（例如用
runtime.NumGoroutine()设阈值） - 避免检查跨节点资源（如 Redis 主从状态、MySQL 主库地址）——那是服务治理层该干的事
真正难的是：当 Fiber 服务因 GC STW 或协程调度卡住时，/health 仍可能返回 200，但实际已不可用。这种场景需配合外部探针（如进程级 kill -0 $PID）或更细粒度的指标暴露（如 Prometheus /metrics + Alertmanager）。
Nacos 对健康检查路径的匹配是精确字符串匹配，不支持通配符或重定向；Fiber 的中间件顺序也会影响健康检查响应（比如 JWT 验证中间件拦住了 /health）。最稳妥的做法，是在注册前用 curl -v <a href="https://www.php.cn/link/1633b2e8d8d39ecaf5fd05fd16b4ffd0">https://www.php.cn/link/1633b2e8d8d39ecaf5fd05fd16b4ffd0</a> 实测响应码、头、体，再确认 Nacos 控制台里该实例的“健康状态”列是否实时更新。
