Fiber.Group 本质是预置前缀和中间件的路由分组工具,不支持自动扫描控制器或资源路由;所有路由必须显式调用 Get()/Post() 等方法注册,推荐用 map 驱动批量注册以提升可维护性。

fiber.Group 本质是批量绑定的入口
Fiber 没有像 Laravel 那样的 Route::controller() 或 ThinkPHP 的资源路由自动映射,所谓“批量绑定”,实际是靠 Group + 手动调用多个 Add() 方法(或其封装如 Get()、Post())来实现的。关键点在于:Group 本身不执行批量注册,它只是把前缀和中间件预置好,后续每条路由仍需显式声明。
-
Group返回的是一个实现了Router接口的对象,和App行为一致,所以你可以链式调用Get()、Post()等 - 前缀路径会自动拼接,比如
app.Group("/api/v1")后调用.Get("/users", handler),最终注册的是/api/v1/users - 如果在
Group创建时传入了handlers(即中间件),它们会被标记为use=true,对组内所有路由生效
别误用 Group 的 “批量” 语义
常见错误是以为 Group 能自动扫描控制器方法或按约定绑定 —— Fiber 完全不提供这种能力。你写 grp.Get("/users", h1).Post("/users", h2),就是两条独立路由;漏写某条,就不会存在。没有隐式反射、没有方法名到 HTTP 动词的自动推导。
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景,三层路由架构(触发词→SAD反馈→DAG编排),recall@10=96.97%。配置驱动(chains.yaml),零代码扩展。pip install skill-weave-chains 一键安装。
- 不存在类似
Route::resource()的快捷方法,必须手动为每个端点指定动词和路径 - 不要试图把整个控制器结构“挂”到 group 下,Fiber 的设计哲学是显式优于隐式
- 若真想减少重复,可封装一个函数接收 handler 映射表,内部循环调用
Get()/Post(),但仍是显式注册
用 map 驱动的批量注册(推荐实操方式)
最接近“批量绑定”的可控做法,是用一个 map[string]fiber.Handler 描述路径与处理器关系,再遍历注册。这样逻辑集中、易维护,也避免手写几十行 .Get().Post().Put()。
// 示例:按路径前缀统一注册一组 API
api := app.Group("/api/v1")
routes := map[string]fiber.Handler{
"/users": userHandler.List,
"/users/:id": userHandler.Get,
"/posts": postHandler.List,
"/posts/:id": postHandler.Get,
}
for path, h := range routes {
api.Get(path, h)
}
- 注意:这里只用了
Get(),如需支持其他动词,得拆成多个 map 或用结构体封装动词+路径+handler - 路径中的
:id是 Fiber 的参数语法,不是正则,无需额外配置;它等价于{id}(Fiber 支持两种写法) - 这种写法不改变路由匹配性能,底层仍是线性栈插入,和手写无异
为什么不用反射自动绑定?
Fiber 明确放弃运行时反射扫描控制器,核心原因有二:一是 Fasthttp 基础上追求极致启动速度和内存效率,反射会增加初始化开销;二是 Go 的类型系统不支持 PHP/Laravel 那种动态方法调用语义,硬做会牺牲类型安全和 IDE 支持。
- 你无法像 PHP 中那样写
UserController@index字符串然后由框架解析调用 —— Go 编译期就要求函数地址确定 - 所有 handler 必须是
fiber.Handler类型(即func(*fiber.Ctx)),不能靠字符串拼接或反射获取 - 真正需要“控制器类”组织逻辑时,建议用结构体方法封装 handler,再显式绑定,而非幻想框架替你发现方法
Group 的中间件只影响其子路由,但不会改变 handler 的签名或注入行为;所有参数提取(如 c.Params("id"))仍需在 handler 内显式写,没有模型绑定、没有自动解包。


















