本文介绍如何使用 gorilla mux 仅通过一个 handler 实现对 `/org/{subdomain}/{name}/promote` 和 `{subdomain}.domain.com/{name}/promote` 两种 url 形式的统一匹配与分发，避免重复注册 handler，提升路由可维护性。
在构建多租户或组织隔离型 Web 应用时，常需同时支持路径式（如 /org/acme/app/promote）和子域名式（如 acme.domain.com/app/promote）两种路由风格。Gorilla Mux 原生不支持跨 Host/Path 组合的“联合变量匹配”，但可通过自定义 http.Handler 作为中间调度器（dispatcher），将不同入口的路由变量归一化后交由同一逻辑处理——从而真正实现「一份业务逻辑、两种访问方式」。
核心思路是：
- 利用 mux.Vars(r) 提取已解析的路由变量（无论来自 Path 还是 Host）；
- 构建唯一键（如 struct{subdomain, name string}）映射到具体 handler；
- 将该调度器注册为两个路由的终点 handler，而非重复绑定多个 HandleFunc。
以下为完整可运行示例：
package main
import (
"fmt"
"net/http"
"github.com/gorilla/mux"
)
// 路由键：由 subdomain 和 name 共同构成唯一标识
type routeKey struct {
subdomain, name string
}
// 调度器：基于 routeKey 分发请求
type dispatcher map[routeKey]http.Handler
func (d dispatcher) ServeHTTP(w http.ResponseWriter, r *http.Request) {
vars := mux.Vars(r)
key := routeKey{
subdomain: vars["subdomain"],
name: vars["name"],
}
if handler, ok := d[key]; ok {
handler.ServeHTTP(w, r)
return
}
http.NotFound(w, r)
}
func handlePromote(w http.ResponseWriter, r *http.Request) {
vars := mux.Vars(r)
fmt.Fprintf(w, "✅ Promote page for org='%s', app='%s'\n",
vars["subdomain"], vars["name"])
}
func main() {
r := mux.NewRouter()
// 【路径模式】匹配 /org/{subdomain}/{name}/promote
r.HandleFunc("/org/{subdomain}/{name}/promote", handlePromote).
Methods("GET")
// 【子域名模式】匹配 {subdomain}.domain.com/{name}/promote
// 注意：Host 正则确保 subdomain 仅含小写字母，增强安全性
r.Host("{subdomain:[a-z]+}.domain.com").
Subrouter().
HandleFunc("/{name}/promote", handlePromote).
Methods("GET")
// ✅ 更优方案：统一调度器（推荐）
// dispatcher 可复用，且便于动态注册/热更新
Dispatcher := dispatcher{
{"acme", "dashboard"}: http.HandlerFunc(handlePromote),
{"beta", "analytics"}: http.HandlerFunc(handlePromote),
// 后续新增租户只需在此添加，无需修改路由注册逻辑
}
// 两条路由共用同一 dispatcher 实例
r.Handle("/org/{subdomain}/{name}/promote", Dispatcher)
r.Host("{subdomain:[a-z]+}.domain.com").Path("/{name}/promote").Handler(Dispatcher)
fmt.Println("Server starting on :8080...")
http.ListenAndServe(":8080", r)
}关键注意事项：
- ✅ 变量命名一致性：两个路由中必须使用完全相同的变量名（如 subdomain、name），否则 mux.Vars(r) 无法对齐；
- ✅ Host 匹配需启用 Subrouter：.Host().Subrouter() 是正确写法，直接 .Host().HandleFunc() 在旧版 mux 中可能失效（v1.8+ 推荐显式 Subrouter）；
- ⚠️ 生产环境须配置 TLS + Host 头校验：子域名路由依赖 Host 请求头，反向代理（如 Nginx）需透传 Host 并设置 proxy_set_header Host $host;；
- ? 扩展性建议：可将 dispatcher 改为线程安全的 sync.Map 或对接数据库/配置中心，实现运行时路由热加载。
该方案不仅消除了逻辑冗余，更将路由声明与业务处理解耦——路由层专注匹配，调度层专注分发，handler 层专注业务，符合清晰分层的设计原则。
