租户标识优先从X-Tenant-ID Header获取，子域名绑定时解析Host，路径前缀则用EscapedPath标准化后提取；版本路由须用gorilla/mux等支持变量的路由器，统一注册通配路径并中间件分发；handler查表用两级map，超千租户用sync.Map；测试需隔离上下文并覆盖边界场景。
租户标识从哪来：HTTP Header 还是 Host 或 Path？
API 版本分发必须先稳定提取租户上下文，否则后续逻辑全错。实际中 X-Tenant-ID Header 最常用，但要注意：如果租户绑定在子域名（如 acme.api.example.com），就该优先解析 Host；若租户信息藏在路径前缀（如 /t/acme/v2/users），则需用 http.StripPrefix 配合路由匹配，不能硬拆 Request.URL.Path —— 否则会破坏 http.ServeMux 的路径规范化逻辑。
常见错误：在中间件里直接 strings.Split(r.URL.Path, "/") 取第二段当租户名，结果遇到 //t/acme/ 或带查询参数的路径就崩。正确做法是用 r.URL.EscapedPath() 先标准化，再按路由注册时约定的结构提取。
版本路由怎么注册：用 gorilla/mux 还是原生 http.ServeMux？
原生 http.ServeMux 不支持动态路由变量，无法实现「同一路径、不同租户走不同 handler」。必须用支持中间件和上下文注入的路由器，gorilla/mux 是最轻量稳妥的选择。关键不是它多强大，而是它允许你在 Router.Use() 中统一注入租户+版本解析逻辑，并通过 mux.Vars(r) 或自定义 context.Context 传递下游。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 不要为每个租户+版本组合注册独立路由（比如
/t/acme/v2/users和/t/beta/v1/users分开HandleFunc），维护爆炸式增长 - 统一注册通配路径如
/t/{tenant}/v{version:/[0-9]+}/{path:.*}，再在 handler 里根据tenant和version查表分发 - 版本号建议只取主版本（
v1、v2），忽略次版本（v2.1）—— Go 生态极少做语义化次版本兼容，强行支持反而增加路由歧义
handler 分发逻辑写在哪：中间件里还是每个 handler 开头？
必须收口到中间件。把租户校验、版本解析、handler 查找全塞进一个 tenantVersionMiddleware，避免每个业务 handler 重复写 if tenant == "acme" && version == "2" { ... }。查表结构推荐用两级 map：map[string]map[string]http.HandlerFunc，外层 key 是租户 ID，内层 key 是版本字符串（如 "v2"）。
性能注意点：
- map 查找是 O(1)，但 map 初始化要放全局变量或依赖注入容器里，别每次请求都
make(map) - 如果租户数超千级，考虑用
sync.Map替代普通 map，避免读写锁争用 - 务必设置兜底 handler（如租户未注册或版本不支持时返回
406 Not Acceptable），别让 panic 泄露到 HTTP 层
怎么测租户隔离：用 httptest.NewRequest 模拟多租户请求
单元测试最容易漏掉的是租户上下文污染。比如在测试里用同一个 http.ServeMux 实例跑多个租户请求，而中间件没清空 context，导致后一个请求拿到前一个租户的值。
正确写法：
- 每个测试用例构造独立
*http.Request，显式设置r.Header.Set("X-Tenant-ID", "acme")或r.Host = "acme.api.test" - 用
httptest.NewRecorder()捕获响应，检查状态码和 body 是否符合该租户+版本的预期 - 特别验证边界场景：租户 ID 为空、版本格式非法（如
vabc）、租户存在但该版本未实现——这些必须有明确错误响应，不能 fallback 到默认版本
真实部署时，租户定制的核心复杂点不在代码分发，而在配置同步：每个租户启用哪些 API 版本、是否允许降级、灰度比例——这些得从外部配置中心加载，不能硬编码在 handler 表里。否则改个租户策略就得发版。
