kratos gateway 是可编程网关库，需用 kratos.new() 启动完整生命周期；必须提前注册 config.provider、手动绑定 http 路由、自定义 proxy.roundtripper 实现负载均衡、显式配置 errorwriter 对齐状态码。
直接说结论：Kratos Gateway 本身不是开箱即用的“网关服务二进制”，它是一套可编程的网关构建库，必须基于 kratos.New() 启动完整生命周期；所谓“深度定制”，本质是替换 Router、重写 Middlewares、接管 Proxy 行为，而不是改配置文件就能上线。
为什么 kratos.New() 启动就 panic，却查不到配置路径？
因为 kratos.New() 内部会立即触发 conf.Load()，但你没提前注册任何 config.Provider。它不报 “找不到 app.yaml”，而是直接 panic: no config provider registered——错误里没有文件名、没有堆栈，纯靠经验定位。
- 必须在
main()函数第一行调用conf.Load(config.NewFile("configs/gateway.yaml"))，不能等日志或 flag 初始化完再做 -
configs/gateway.yaml必须存在且可读，否则c.Load()返回 error，要显式检查，否则后续 panic 更难追 - 别依赖
$CONFIG_PATH环境变量自动替换，config.NewFile(os.Getenv("CONFIG_PATH"))得自己拼，Kratos 不解析变量语法
HTTP 路由 404，但 gRPC 能连上，说明什么？
说明进程活着，http.Server 实例也启了，但路由根本没挂到 mux 上。Kratos Gateway 的 HTTP 路由不是自动扫描注册的，全靠你手动调用 v1.RegisterGatewayHTTPServer() 绑定。
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
- 确认
internal/server/http.go中创建了http.NewServer()实例，并传入了handler（通常是*gin.Engine或自定义http.ServeMux） - 确认
api/v1/gateway_http.pb.go已生成（即make api成功），否则RegisterGatewayHTTPServer函数根本不存在 - 确认 proto 中
option (google.api.http)正确声明了路径，比如get: "/v1/route"，不是get: "/route"；前缀/v1是硬编码在生成逻辑里的 - 漏传
httpSrv到kratos.New(kratos.Server(httpSrv, grpcSrv))，等于没启用 HTTP 监听
想改负载均衡策略，为什么 wrr 不生效？
因为 Kratos 默认的 Selector 实现只在 Client 层起作用，而 Gateway 的 Proxy 流程绕过了它——Proxy 直接拿 Node 列表做转发，不走 Selector.Select()。你要改的是 proxy.RoundTripper 的实现，不是换 selector.WithPolicy()。
- 必须自定义
proxy.RoundTripper，在RoundTrip()中手动调用selector.Select()获取目标节点 - 原生
wrr策略依赖discovery.Instance的Weight字段，确保服务注册时填了该字段（如 Consul 的meta["weight"]） - 若用
p2c，注意它需要健康检查反馈，否则会退化成随机选择；proxy层默认不做健康探测，得自己加healthcheck中间件或复用transport/http.Client的重试机制 - 不要试图在
middleware里改context中的node，Proxy不读那个字段
协议转换时 gRPC 响应 status code 错乱，怎么对齐？
HTTP → gRPC 转换时，Kratos 默认把 HTTP status 映射为 gRPC Code，但反向（gRPC → HTTP）不自动反推——status.Code 会被丢弃，返回固定 200 OK，除非你显式注入 transport/http.ErrorWriterFun。
- 必须在
http.NewServer()构造时传入自定义ErrorWriter，例如：http.ErrorWriter(errorWriter) -
errorWriter函数里需解析errors.IsGRPC()，并根据status.FromError(err).Code()映射到对应 HTTP status（如codes.Unavailable → 503） - 别依赖
kgin.Error()，它是给 Gin 用的；Gateway 的Proxy流程走的是底层http.RoundTripper，不经过 Gin 中间件链 - 若用
grpc-gateway替代 Kratos 的Proxy，映射规则完全不同，且不支持gRPC → gRPC场景
最常被忽略的一点：Kratos Gateway 的 Proxy 是无状态转发，所有定制逻辑都得落在 RoundTripper 或前置 Middlewares 里；想在转发后修改响应体？得自己实现 http.ResponseWriter 包装器，而不是幻想中间件能“拦截 response”。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
