gin 的 group 是构建期行为，路由树启动后固化，运行时动态挂载会引发竞态 panic；租户识别应通过中间件安全提取子域名并校验，所有下游调用必须显式传入 tenant 上下文以确保隔离。
为什么不能用 Gin 的 Group 动态挂载租户路由
Gin 的 router.Group() 是构建期行为，gin.Default() 启动后整个路由树就固化了。你没法在请求进来时根据 Host 或路径动态 new 一个新 group 并注册子路由——这不是设计缺陷，而是架构选择：Gin 把路由匹配和 handler 组装完全分离，匹配只发生在请求进入的瞬间，不支持运行时重入或树结构变更。
常见误操作是写个中间件去调 r.Group("/t/" + tenant) 再塞 handler，结果 panic：fatal error: concurrent map writes。因为 Group() 内部会直接修改底层 trie 节点指针，而多个 goroutine 同时写必然触发 Go runtime 的竞态检测。
- 所有路由必须在
http.ListenAndServe前注册完毕 - 试图用 mutex 包住
router.POST()也没用——树节点之间的 link 关系不是靠锁能保护的 - 本地开发时若 Host 是
localhost或127.0.0.1，记得加白名单跳过租户提取，否则c.Param("tenant")永远为空
如何安全提取子域名中的租户标识
子域名提取不是简单切字符串。直接用 r.Host 会拿到带端口的值（如 tenant1.example.com:8080），导致 strings.Split(r.Host, ".")[0] 取出的是 tenant1 还是 8080 完全看运气。
正确做法是先用 net.SplitHostPort() 安全剥离端口，再对纯 host 做两级切分，并严格比对主域名：
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 { // mainDomain := "example.com"
tenantID = parts[0]
}
- 硬编码主域名（如
"example.com"）比正则更可靠，换域名时只需改一处常量 - 别用
regexp.MustCompile(`^([a-z0-9-]+)\.example\.com$`)，编译开销大且无法复用 - 提取失败时应返回 400 而非 404，避免暴露租户存在性
租户路由该用通配符还是中间件注入
答案是：用中间件注入，别碰 /*tenant 这类通配符路由。Gin 的 *filepath 通配符会禁用同级所有静态路径的前缀剪枝优化，一旦注册，整棵子树匹配性能直线下滑。
真正该做的是在全局中间件里完成三件事：租户识别、有效性校验、上下文注入。之后所有 handler 只需从 c.MustGet("tenant") 拿值，再传给 tenantDB(tenant).Query() 这类封装好的方法。
- 避免在每个 handler 里重复查数据库确认租户状态——中间件里查一次，写进 context 就够了
- 不要用
switch tenantID硬编码分支逻辑，这会让代码随租户数线性膨胀 - 所有 DB/Cache/Config 调用必须显式传入 tenant 上下文，否则就是数据越界隐患
gorilla/mux 的 {tenant} 正则约束为什么不能省
gorilla/mux 默认的 {tenant} 变量捕获不校验格式，/t/..%2fetc/passwd 这种路径会被原样塞进 vars["tenant"]，后续拼接文件路径或 SQL 查询极易引发目录穿越或注入。
必须加正则约束，且要兼顾可读性与安全性：
r.PathPrefix("/t/{tenant:[a-z0-9][a-z0-9-]{2,29}}").Handler(tenantDispatcher)
- 开头
[a-z0-9]防止以-开头（部分系统解析异常） - 长度限制
{2,29}是为兼容 DNS 标签规范（最长 63 字符，但留出主域名空间） - 不用
[a-zA-Z0-9_-]，因为下划线_在 DNS 中非法，实际部署会失败
最易被忽略的一点：租户隔离真正的难点不在路由匹配，而在 handler 执行时所有下游调用（DB、Redis、HTTP client）是否都已绑定 tenant 上下文——漏掉任意一环，多租户就形同虚设。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
