Beego通过控制器方法名(Get/Post/Put/Delete等)与HTTP动词隐式映射实现RESTful自动分发,无需手动判断method;默认启用,需严格命名;也可在router.go中用字符串映射显式绑定多方法。

在Beego中实现按HTTP请求方法(GET/POST/PUT/DELETE等)自动分发到对应控制器方法,是构建标准RESTful API的底层机制,必须依赖框架对控制器方法名与HTTP动词的隐式映射规则,不能靠手动判断method字段。
启用默认RESTful分发机制
Beego默认开启RESTful风格路由,只要控制器结构体实现了标准方法名,框架就会自动绑定。无需额外配置开关。
在controllers/user.go中定义控制器,确保包含大写首字母的Get、Post、Put、Delete等方法:
【方法名必须严格为Get/Post/Put/Delete/Patch/Head】——小写get或自定义如ListUsers将被忽略,请求会返回404。
运行bee run后,访问GET /user即触发UserController.Get(),POST /user触发UserController.Post(),以此类推。
显式声明多方法路由(推荐用于非标准路径)
当一个URL需支持多种方法但控制器不满足默认命名约定,或想限制只开放部分方法时,用字符串映射语法:
在routers/router.go中添加:
beego.Router("/api/v1/profile", &controllers.ProfileController{}, "get:GetProfile;post:UpdateProfile;delete:RemoveProfile")
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景,三层路由架构(触发词→SAD反馈→DAG编排),recall@10=96.97%。配置驱动(chains.yaml),零代码扩展。pip install skill-weave-chains 一键安装。
这行代码把/api/v1/profile这个路径的三种请求,分别绑定到控制器内三个具体方法上。注意中间用分号隔开,冒号前是HTTP方法,冒号后是控制器内方法名。
如果漏写某个方法(比如没写put:),则对该路径发起PUT请求时直接返回405 Method Not Allowed。
验证分发是否生效
第一步:启动服务后,在终端观察日志,看到类似[INFO] 2026/08/20 19:49:12 Router is mapping /user to controllers.UserController说明路由已注册。
第二步:用curl测试不同方法:
curl -X GET http://localhost:8080/user → 应触发Get方法
curl -X POST -H "Content-Type: application/json" -d '{"name":"test"}' http://localhost:8080/user → 应触发Post方法
第三步:在对应控制器方法第一行插入logs.Info("Hit Get method"),查看控制台输出是否匹配请求动作。










