gin.Default()不能直接支持多子域名路由，因其不解析Host头而只匹配路径；需用map[string]*gin.Engine在http.Handler层解析Host、标准化（去端口/转小写/预编译通配符正则）后O(1)查表转发。
为什么 gin.Default() 不能直接支持多子域名路由
因为 gin.Engine 本身不解析 HTTP 请求头里的 Host 字段，它只做路径匹配。所有请求无论来自 api.example.com 还是 admin.example.com，只要路径是 /users，就会进同一个 r.GET("/users", ...) 处理函数——这根本不是“按子域名分发”，只是路径复用。
怎么用 map[string]*gin.Engine 实现 O(1) 域名查表
核心是自己接管 Host 解析，在顶层 http.Handler 里查表转发：
- 启动时加载白名单：用
map[string]struct{}存标准化域名（小写、去端口、通配符需转正则预编译） - 每个子域名对应一个独立
*gin.Engine实例，必须用gin.New()创建，不能共用gin.Default() - 顶层 handler 中提取
r.Host，标准化后查 map，命中则调用subRouter.ServeHTTP(w, r) - 注意别传
r.Context()过去——ServeHTTP会新建 context，避免生命周期污染
域名标准化时容易忽略的三个细节
直接拿 r.Host 查表会漏匹配或误匹配：
Skill Weave Chains — 技能链路由引擎
下载
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
-
r.Host可能带端口，比如api.example.com:443，得用strings.Split(r.Host, ":")[0]切掉 - 大小写敏感：DNS 域名不区分大小写，但 Go 的 map key 区分，必须统一
strings.ToLower() - 通配符处理：
*.example.com不能直接当 key 存，要转成正则^[a-z0-9.-]+\.example\.com$并预编译，否则每次查都要 re.Compile
转发到子 router 时最常踩的坑
错误写法会导致 panic、中间件失效或 context 超时：
- 用
c.Next()或c.Abort()在顶层 handler 里——*gin.Context只属于当前 router，跨 router 无效 - 调用
subRouter.ServeHTTP前手动写了响应头或状态码——会触发http: multiple response.WriteHeader calls - 子 router 用了
gin.Default()——它的Recovery和Logger会跟顶层冲突，日志重复、panic 捕获错乱 - 没设
subRouter.Use(...)就注册路由——子路由没中间件，比如 CORS、Auth 全部失效
真正关键的不是“怎么写路由”，而是“谁来决定把请求交给哪个 router”。这个决策点必须在 net/http 层完成，且不能干扰 gin 内部 context 生命周期。稍有不慎，debug 时看到的 panic traceback 会指向 gin 源码里完全无关的行号。
