fiber 不支持可选路由参数（如 /user/:id?），必须显式注册多条路由（如 /user 和 /user/:id）并共享 handler；其 radix tree 引擎仅支持静态段、参数段和通配段，无“存在或不存在都匹配”语义。
可选路由参数在 Fiber 中根本不存在
Fiber 的路由系统不支持真正的“可选参数”，比如 /user/:id? 这种写法会直接报错或被当作静态路径字面量处理。它的 radix tree 路由引擎只识别三类节点：静态段（/users）、参数段（/user/:id）、通配段（/static/*filepath），没有“该段存在或不存在都匹配”的语义。
你看到的“可选效果”，其实是靠组合多个明确注册的路由 + 共享 handler 实现的，不是语法层面的支持。
-
:id参数段必须存在且非空，/user/和/user都不会匹配/user/:id - 想让
/user和/user/123都走同一逻辑，就得显式注册两条路由：app.Get("/user", handler)和app.Get("/user/:id", handler) - 别试图用
app.Get("/user/:id?", ...)—— 这不是合法路由定义，Fiber v3 会 panic 或静默忽略
用多条路由 + 共享 handler 模拟可选行为
最稳妥、最符合 Fiber 设计哲学的做法，是把“可选”拆成多个确定路径，并复用同一处理函数。这样语义清晰、调试可见、性能无损。
例如实现「获取用户列表 or 获取单个用户」共用一个逻辑：
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
func userHandler(c fiber.Ctx) error {
id := c.Params("id")
if id == "" {
return c.JSON([]string{"user1", "user2"}) // 列表
}
return c.JSON(map[string]string{"id": id, "name": "Alice"})
}
app.Get("/user", userHandler)
app.Get("/user/:id", userHandler)
- 注意
c.Params("id")在/user路径下返回空字符串，不是nil或 panic，可安全判断 - 不要在 handler 内部做路径解析（如
strings.Split(c.Path(), "/")），那绕过了 radix tree 优化，也破坏了 Fiber 的上下文生命周期 - 如果还有
/user/:id/profile这类子路径，必须单独注册，它不会继承/user/:id的 handler
StrictRouting 开关对“可选”场景的实际影响
开启 StrictRouting: true（默认）时，/user 和 /user/ 是两个独立路径；关闭后，/user/ 会被降级匹配到 /user，看似“变可选”，但代价是路由歧义风险陡增。
- 若同时注册了
app.Get("/user", ...)和app.Get("/user/:id", ...)，关掉StrictRouting后，/user/123仍能匹配后者，但/user/会匹配前者——这看起来“凑合”，但一旦加了/user/new这种静态路径，就可能被/user/:id错误捕获 -
/user/匹配/user是降级行为，不是设计目标；Fiber 明确建议用重定向或显式注册，而非依赖这个开关“模拟可选” - 生产环境禁用
StrictRouting会放大路由维护成本，尤其当团队多人协作、OpenAPI 文档和前端调用不统一时，404 会变得不可预测
用自定义约束 + fallback 路由兜底更可控
如果你真正需要的是“参数存在时校验格式，不存在时不报错”，可以用 RegisterCustomConstraint 配合一条兜底路由，比硬写多个 if 更清晰。
比如只允许 id 是 ULID 格式，否则走默认逻辑：
// 注册 ulid 约束（见知识库示例）
app.RegisterCustomConstraint(&UlidConstraint{})
// 带约束的路由：只匹配合法 ULID
app.Get("/user/:id<ulid>", func(c fiber.Ctx) error {
return c.JSON(map[string]string{"id": c.Params("id"), "type": "ulid"})
})
// 兜底路由：匹配所有 /user/*，包括 /user/ 和 /user/abc
app.Get("/user/*", func(c fiber.Ctx) error {
path := c.Params("*")
if path == "" {
return c.JSON([]string{"fallback list"})
}
return c.JSON(map[string]string{"path": path, "type": "fallback"})
})
</ulid>
- 注意
/user/*必须放在带约束路由之后，因为 Fiber 按注册顺序尝试匹配，通配节点会吃掉所有剩余路径 - 这种写法把“校验失败”显式转为“走另一条路由”，比在 handler 里做字符串判断更符合中间件分层思想
- 但别滥用通配：它无法提取命名参数，
c.Params("id")在/user/*下永远为空，只能靠c.Params("*")拿原始路径片段
:id? 生效，却忘了检查前端 SDK 是否真的在发 /user/ 这种结尾斜杠路径——而这个问题，用一行重定向中间件就能根治。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
