Go HTTP服务器通过解析Host头提取租户标识，需用net.SplitHostPort安全分离端口，再按主域名切分；Gin不支持运行时子域名路由组，应统一定义路由并在中间件中完成租户识别、校验与上下文注入。
Go HTTP 服务器如何解析子域名并提取租户标识
子域名路由的本质是拿到请求的 Host 头，从中剥离出租户名。Gin 或 net/http 默认都不自动做这层解析，得自己写逻辑。
常见错误是直接用 r.Host 或 r.URL.Host，但没处理端口（如 tenant1.example.com:8080），导致提取失败；或者硬编码主域名做字符串切分，一换域名就崩。
- 用
net.SplitHostPort安全拆分 host 和端口，再对结果取strings.SplitN(host, ".", 2)得到租户前缀 - 主域名必须配置为常量（如
const mainDomain = "example.com"），不能写死在正则里 - 注意本地开发时 Host 可能是
localhost或127.0.0.1，需加白名单或跳过租户提取
// 示例：从 *http.Request 提取 tenantID
host := r.Host
if h, _, err := net.SplitHostPort(host); err == nil {
host = h
}
parts := strings.SplitN(host, ".", 2)
if len(parts) == 2 && parts[1] == mainDomain {
tenantID = parts[0]
}
Gin 中按子域名动态挂载路由组是否可行
不可行。Gin 的 router.Group() 是构建期行为，一旦 gin.Default() 启动，路由树就固定了，没法在请求进来时“临时创建一个新 group”。想靠子域名切换整套路由逻辑，得换思路。
真正可行的是：所有租户共用一套路由定义，但在 handler 入口处根据 tenantID 做分支，或用中间件注入租户上下文。
立即学习“go语言免费学习笔记（深入）”；
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 避免在 handler 里重复查数据库确认租户有效性——应提前在中间件中完成校验并写入
c.Set("tenant", t) - 不要用
switch tenantID硬编码路由分支，而是把租户相关逻辑封装成结构体方法，比如tenantDB(tenantID).Query(...) - Gin 的
c.Param和c.Query不受子域名影响，该用照用，但所有 DB/Cache/Config 调用必须显式传入 tenant 上下文
为什么用中间件做租户隔离比改路由更稳
因为路由只管“谁来访问”，而租户隔离要管“访问时用哪套数据、配哪套策略、走哪条限流规则”。这些都发生在请求生命周期中段，不是靠 URL 路径或 host 就能静态决定的。
典型翻车场景：某租户开了自定义域名（brand.tenant.com），但你路由只认 *.example.com，结果租户流量进不来；或者租户停用后 DNS 没及时清理，请求仍能走到服务但数据错乱。
- 中间件里做租户识别 + 缓存（如
sync.Map存tenantID → *TenantConfig），比每次查库快得多 - 必须在中间件末尾调用
c.Next()前校验租户状态（active？过期？配额超限？），否则后续 handler 一律不该执行 - 日志和 traceID 必须打上
tenant_id字段，否则排查问题时根本分不清是哪个租户的请求
子域名路由在反向代理（Nginx / Cloudflare）下的坑
Go 服务收不到原始 Host，是因为代理默认改写了 Host 头。Nginx 不加配置时会把 Host 设成 upstream 地址（如 127.0.0.1:8080），Cloudflare 默认也不透传原始 Host。
不修这个，你的子域名提取逻辑从第一步就失效。
- Nginx 需显式设置
proxy_set_header Host $host;（注意不是$http_host，后者可能带端口） - Cloudflare 要开启 “Preserve original host header”（企业版功能，免费版不支持）
- 本地用
curl -H "Host: tenant1.example.com" http://localhost:8080测试时，Go 服务收到的 Host 就是伪造的，别当成线上表现
租户路由真正的复杂点不在 Go 代码怎么写，而在于 DNS、CDN、WAF、LB 这几层能不能把原始 Host 完整、稳定、可预期地透传下来。少一环，整个多租户链路就断在入口。
