Hertz 不是部署型中间件，而是需通过 server.Default() 或 server.New() 初始化并启动的 HTTP 服务主体；其默认基于 Netpoll 网络库，无法以 http.Handler 形式挂载到标准 net/http.Server 上，强行调用会 panic。
直接说结论：Hertz 不是“部署”出来的中间件，而是你代码里初始化并启动的 HTTP 服务主体——它本身就是一个 server 实例，不是插在已有服务上的路由层。想用它做高性能路由引擎，就得用 server.Default() 或 server.New() 创建实例，再注册路由、中间件、启动监听。
为什么不能像 Gin 那样“接入”现有 net/http 服务
Hertz 底层默认不走 Go 标准库 net/http，而是用自研 Netpoll 网络库接管连接生命周期。这意味着它无法以 http.Handler 形式被挂载到 http.Server 上——调用 h.ServeHTTP(w, r) 会 panic。
- 常见错误现象：
panic: interface conversion: http.Handler is not hertz.Engine或运行时提示 “no handler registered” - 真正兼容
net/http的方式仅限于启用WithStdHttp选项（性能下降约 25%，且部分特性如流式响应不可用） - 如果你已有
http.Server实例并想复用，必须重构：把路由逻辑迁入 Hertz，用h.Spin()启动，而非http.ListenAndServe
server.Default() 和 server.New() 的关键区别
server.Default() 是快捷入口，内置了日志、恢复（recover）、压缩等常用中间件；server.New() 是裸实例，所有中间件需手动注册——选哪个取决于你是否需要开箱即用的可观测性基础。
-
server.Default()默认监听:8888，但端口可后续通过h.serve(...)覆盖；它也自动启用Netpoll，无需额外配置 -
server.New()更适合嵌入测试或需要完全控制中间件顺序的场景，比如你想把鉴权中间件放在日志之前 - 两者都支持传入
config.Option，例如server.WithHostPorts("0.0.0.0:9000")或server.WithTransport(transport.StdHttp)
Docker + Kubernetes 场景下必须显式指定监听地址
K8s Pod 内部网络模型要求服务绑定到 0.0.0.0，而 Hertz 默认只监听 127.0.0.1（本地回环）。不改会导致 readinessProbe 失败、Pod 卡在 ContainerCreating 状态。
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
立即学习“go语言免费学习笔记（深入）”；
- 正确写法：
h := server.Default(server.WithHostPorts("0.0.0.0:8888")) - 如果用了
server.New()，记得补上h.Use(middleware.Recovery())等基础中间件，否则 panic 会直接 kill 进程 - 在 Dockerfile 中确保暴露端口与代码一致：
EXPOSE 8888，且 K8scontainerPort必须匹配
别忽略 Netpoll 的 FD 限制和 CPU 绑核影响
Netpoll 在高并发下依赖系统文件描述符数量和 CPU 亲和性。默认配置在容器中容易因 ulimit 不足或调度抖动导致连接拒绝（accept: too many open files）。
- 启动前检查：
ulimit -n至少设为 65536；K8s 中通过securityContext设置fsGroup和ulimits - 生产环境建议开启
server.WithGOMAXPROCS并配合runtime.GOMAXPROCS控制协程数，避免单核过载 - Netpoll 默认启用
SO_REUSEPORT，但在旧内核（lsof -i :8888 是否显示多个 worker 进程监听同一端口
真正麻烦的从来不是怎么写第一行 h := server.Default()，而是当 QPS 超过 5k 后，你得回头检查 ulimit、GOMAXPROCS、Netpoll 日志里的 conn close due to read timeout ——这些细节不会报错，但会让延迟毛刺肉眼可见。
