Fiber不是微服务框架，仅处理HTTP层；构建微服务需手动集成服务发现、健康检查、链路透传等能力，否则仅为单体服务。
为什么 Fiber.Listen() 启动后无法被其他服务发现
Fiber 默认只启动一个监听地址（如 :3000），不带任何服务元数据上报逻辑。Consul、Nacos 或 Eureka 不会自动感知它——你得手动集成注册客户端。
- 启动前调用 Consul API 注册服务：用
consul-api库发 PUT 请求到/v1/agent/service/register，携带 ID、Name、Address、Port、Check 等字段 - 关闭前需主动注销：监听
os.Interrupt信号，在app.Shutdown()后调用/v1/agent/service/deregister/{id} - 健康检查端点要自己暴露：比如加一个
GET /health路由，返回{"status": "UP"}，并在 Consul 注册时配置http+interval
如何让 Fiber 接口兼容 OpenAPI 3 规范
手写路由和文档极易脱节，推荐用 oapi-codegen 自动生成 Fiber 服务端代码，避免参数类型错位或路径拼写错误。
- 准备一个
openapi.yaml，定义/users/{id}的 path、request body、response schema - 执行命令：
oapi-codegen -generate fiber-server -package api openapi.yaml > api/server.gen.go - 生成的
RegisterHandlers()函数会自动绑定所有路由，并把 JSON body 解析逻辑封装进c.BodyParser(&v) - 注意：生成的模型结构体默认用
json:tag，若需兼容 gRPC 或数据库字段名，得额外加gorm:或protobuf:tag
为什么标准库中间件（如 promhttp）在 Fiber 中 panic
Fiber 基于 fasthttp，其 *fiber.Ctx 和 net/http.Handler 完全不兼容。直接传 promhttp.Handler() 会报 cannot use ... as type fiber.Handler。
- 改用社区适配器：
github.com/gofiber/fiber/v2/middleware/prometheus，它内部已做fasthttp封装 - 自定义中间件时别调
c.Request().Header.Get("X-Trace-ID")，应改用c.Get("X-Trace-ID")—— 因为c.Request()返回的是*fasthttp.Request，没有标准http.Request方法 - JWT 验证别依赖
golang.org/x/oauth2的http.Handler实现，要用github.com/gofiber/jwt/v3这类专为 Fiber 写的包
如何让多个 Fiber 微服务共享统一上下文（如 trace_id）
Fiber 没有内置跨服务透传能力，trace_id 必须手动从入参提取、注入下游请求头，并在日志中显式打印。
- 入口中间件提取：
c.Get("X-Trace-ID")，若为空则生成新 ID 并设回c.Set("X-Trace-ID", id) - 下游调用时透传：用
fasthttp.DoTimeout()发请求，手动加req.Header.Set("X-Trace-ID", traceID) - 日志打点不能只靠
fmt.Printf，要用支持字段的 logger（如zerolog），并在每个 handler 开头塞log := logger.With().Str("trace_id", traceID).Logger() - 别依赖
context.WithValue()传递 trace_id —— Fiber 的c.Context()是fasthttp的 context，生命周期与标准net/http不同，容易丢失
