Golang Fiber框架多域名路由配置实战教程-Golang-PHP中文网

必须用app.Host注册Host路由，不可在handler中手动解析c.Host()；泛域名仅支持一级子域名，多级需显式声明；提取子域名应使用c.Hostname()并校验长度；泛域名+路径参数时须显式开启StrictRouting。

golang fiber框架多域名路由配置实战教程

Host路由必须用app.Host，别在handler里手动读c.Host()

Fiber 的 app.Get、app.Post 等方法只匹配路径（Path），对 Host 头完全无感知。你在 handler 里写 c.Host() 做字符串判断，等于把路由逻辑拖到业务层——不仅破坏 Radix 树的早期匹配优势，还会让子域名隔离失效。

常见错误现象：本地用 curl -H "Host: api.example.com" http://localhost:3000/ 能走通，但上线 Nginx 后所有子域名都落到同一个 handler。根本原因是 Nginx 默认不透传 Host 头；即使加了 proxy_set_header Host $host;，也常漏掉 $request_uri，导致路径被重写、Host 匹配失败。

正确做法是直接用 app.Host 注册 Host 专用路由：

api := app.Host("api.example.com")
api.Get("/users", handler.ListUsers)

admin := app.Host("admin.example.com")
admin.Get("/dashboard", handler.Dashboard)

泛域名匹配只支持一级，多级子域名得显式列出来

app.Host("*.example.com") 是合法的，但它只匹配一级子域名：比如 api.example.com 和 shop.example.com 可以，但 dev.api.example.com 或 staging.shop.example.com 不会命中。

多级子域名必须显式注册：

app.Host("dev.api.example.com")
app.Host("staging.shop.example.com")
或统一用二级主域名 + 路径前缀区分环境：app.Host("api.example.com").Get("/dev/users", ...)

注意注册顺序：Fiber 按 app.Host 的调用顺序匹配，先注册的优先。建议把泛匹配 "*.example.com" 放在最后，避免它提前吃掉本该由具体域名处理的请求。

提取子域名要用c.Hostname()，不是c.Host()

c.Host() 返回原始 Host 字符串（含端口，如 api.example.com:3000），而 c.Hostname() 自动剥离端口并标准化（返回 api.example.com）。这是关键区别——用 c.Host() 切分，遇到 HTTPS 重定向或非标端口（如 :8443）就会出错。

Golang Uber Dig

使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等

下载

安全提取租户名示例：

host := c.Hostname()
parts := strings.Split(host, ".")
if len(parts) >= 3 {
    tenant := parts[0] // api.example.com → "api"
}

别用正则硬匹配 ^([a-z0-9]+)\.example\.com$：Fiber 不校验 Host 合法性，恶意请求如 evil..example.com 会导致 parts[0] 为空字符串。若需支持国际化域名（IDN），得先调 idna.ToASCII(host) 转码。

泛域名 + 路径参数组合时，StrictRouting必须显式开启

当你写 app.Host("*.example.com").Get("/users/:id", handler)，Fiber 默认允许 /users/123/（尾部斜杠）也匹配——但在泛域名场景下，这个松散行为容易引发歧义：不同子域名可能因尾斜杠意外共享同一 handler。

解决办法只有两个：

显式开启 StrictRouting（推荐）：app.Host("*.example.com", fiber.Config{StrictRouting: true})
或统一加中间件重定向：if strings.HasSuffix(c.Path(), "/") && c.Path() != "/" { c.Redirect(strings.TrimSuffix(c.Path(), "/"), 301) }

最容易被忽略的是：泛域名 Host 路由的 fiber.Config 必须在 app.Host() 调用时传入，不能靠全局配置覆盖——每个 Host 分支可独立控制 StrictRouting 行为。