本文介绍如何使用 gorilla mux 实现「路径式」（/org/{subdomain}/{name}/...）与「子域名式」（{subdomain}.domain.com/{name}/...）两种 url 结构共用同一业务处理器，避免重复注册路由，提升代码可维护性。
在构建多租户或组织级 Web 应用时，常需支持两种访问模式：一种是统一入口的路径路由（如 /org/acme/dashboard），另一种是更友好的子域名路由（如 acme.example.com/dashboard）。Gorilla Mux 原生不支持跨 Host/Path 组合的“联合变量匹配”，但可通过自定义 HTTP 处理器（http.Handler）统一提取并分发路由变量，实现逻辑复用。
核心思路是：将业务逻辑封装为独立 handler（如 promoteView），再通过一个中间 dispatcher 处理器，从 mux.Vars(r) 中提取 subdomain 和 name，结合预定义映射表（如 map[key]http.Handler）精准分发请求——无论变量来自路径参数还是 Host 模板，均被标准化处理。
以下是一个生产就绪的示例实现：
package main
import (
"fmt"
"github.com/gorilla/mux"
"net/http"
)
// key 定义路由匹配的唯一标识（子域名 + 主体名称）
type key struct {
subdomain, name string
}
// dispatcher 是一个基于 key 的路由分发器
type dispatcher map[key]http.Handler
// ServeHTTP 实现 http.Handler 接口：统一提取变量、查表、转发
func (d dispatcher) ServeHTTP(w http.ResponseWriter, r *http.Request) {
vars := mux.Vars(r)
subdomain, ok1 := vars["subdomain"]
name, ok2 := vars["name"]
if !ok1 || !ok2 {
http.Error(w, "missing required route variables", http.StatusBadRequest)
return
}
handler, exists := d[key{subdomain, name}]
if !exists {
http.NotFound(w, r)
return
}
handler.ServeHTTP(w, r)
}
func promoteView(w http.ResponseWriter, r *http.Request) {
vars := mux.Vars(r)
fmt.Fprintf(w, "Promote page for org: %s, name: %s\n", vars["subdomain"], vars["name"])
}
func main() {
r := mux.NewRouter()
// ✅ 路径式路由：/org/{subdomain}/{name}/promote
r.Handle("/org/{subdomain}/{name}/promote", dispatcher{
{"acme", "dashboard"}: http.HandlerFunc(promoteView),
{"beta", "admin"}: http.HandlerFunc(promoteView),
// 可按需扩展更多组织-资源组合
})
// ✅ 子域名式路由：{subdomain}.domain.com/{name}/promote
r.Host("{subdomain:[a-z]+}.domain.com").
Path("/{name}/promote").
Handler(dispatcher{
{"acme", "dashboard"}: http.HandlerFunc(promoteView),
{"beta", "admin"}: http.HandlerFunc(promoteView),
})
// ⚠️ 注意：若 dispatcher 实例复用，需确保其线程安全（本例中为只读 map，安全）
// 如需动态增删路由，建议改用 sync.Map 或加锁保护
http.ListenAndServe(":8080", r)
}关键优势与注意事项：
- ✅ 零重复逻辑：promoteView 仅定义一次，所有路由变体共享同一业务函数；
- ✅ 变量标准化：无论 subdomain 来自 Host 还是 Path，均通过 mux.Vars() 统一获取，业务层无感知；
- ✅ 高可扩展性：新增租户只需向 dispatcher 映射表添加新 key-value 对，无需修改路由注册逻辑；
- ⚠️ 正则约束建议：子域名 Host 模板中务必使用正则（如 {subdomain:[a-z0-9-]+}）防止注入或误匹配；
- ⚠️ 404 处理：dispatcher 内置缺失 key 的兜底响应，避免 panic；生产环境建议补充结构化日志；
- ⚠️ 性能考量：对于超大规模路由（万级+），可考虑升级为 trie 树或哈希分片，但常规 SaaS 应用中 map 查找完全足够。
该方案平衡了灵活性、可读性与工程健壮性，是 Gorilla Mux 生态下处理多形态租户路由的经典实践。
