Go语言如何开发Beego框架REST API-Golang-PHP中文网

beego开发rest api的核心是让controller正确响应http方法并跳过模板渲染；需删除controllers/base.go、使用restrouter或手动路由映射、用servejson而非render、确保方法签名无参数无返回值。

go语言如何开发beego框架rest api

Beego 开发 REST API 的核心不是“怎么写接口”，而是“怎么让 Controller 正确响应 HTTP 方法并跳过模板渲染”。默认的 bee api 项目结构已经为你屏蔽了视图层，但很多初学者仍会卡在 404、空响应、JSON 不返回、或意外触发 Render() 导致 panic 上。

用 `bee api` 初始化项目时必须删掉 `controllers/base.go`

新版本 Beego（v2.x）的 bee api apiproject 生成的项目里，controllers/base.go 包含一个继承自 beego.Controller 的 BaseController，它默认重写了 Prepare() 并调用了 CheckLogin() —— 这个方法在纯 API 场景下既无意义又不定义，运行时直接 panic。

实际做法是：

删掉 controllers/base.go 文件（别留空文件，Beego 会尝试加载）
所有 controller 直接嵌入 beego.Controller，例如：type UserController struct { beego.Controller }
如果需要统一鉴权，改用中间件（beego.InsertFilter），而不是靠基类

`Get()`、`Post()` 等方法不生效？检查路由是否启用 REST 模式

Beego 默认路由不自动按 HTTP 方法分发；你写了 Get()，但没配路由规则，请求照样进不到该方法。常见错误是只写 beego.Router("/user", &controllers.UserController{})，这只会把所有方法都打到 URLRouter，而不会触发 REST 分发逻辑。

正确做法只有两种：

Wordpress REST API

OpenClaw技能，提供WordPress REST API命令行工具，支持通过原生HTTP处理文章、页面、分类、标签、用户及自定义请求。

下载

用 beego.RESTRouter：例如 beego.RESTRouter("/api/user", &controllers.UserController{})，此时框架会自动将 GET /api/user → UserController.Get()，POST /api/user → UserController.Post()
或手动注册：用 beego.Router("/api/user", &controllers.UserController{}, "get:Get;post:Post")
注意：RESTRouter 要求 controller 必须实现对应方法，否则返回 405；未实现的方法不会 fallback 到其他 handler

返回 JSON 时别碰 `Render()`，用 `ServeJSON()` 或 `Data["json"]`

Beego 的 Render() 是为 HTML 模板设计的，一旦在 API controller 中被调用（比如忘了注释掉 beego.Controller 基类里的 Prepare() 逻辑），就会尝试加载 views/xxx.tpl，而 bee api 项目压根没 views 目录，直接 500。

API 场景下只用这两招之一：

直接调用 c.ServeJSON()（c 是 controller 实例），前提是已给 c.Data["json"] = yourStructOrMap
或更简洁地：c.Data["json"] = map[string]interface{}{"code": 0, "data": user} + c.ServeJSON()
不要用 c.Render()，也不要用 c.TplName，这些字段和方法在 API 场景下完全多余

`bee run` 报错 “undefined: bee” 或热编译不生效？检查 Go 模块与 `bee` 安装路径

Go 1.16+ 默认启用 module，而老教程里用 go get github.com/beego/bee 会把 bee 安装到 $GOPATH/bin，但若当前项目在 module 模式下（有 go.mod），bee 可能找不到依赖或无法识别项目结构。

解决方式很实在：

确认 bee 已安装且在 $PATH 中：which bee 应输出路径，bee version 应显示 v2.x
项目初始化必须用 bee new -kind=api myapi（不是 bee api，后者是旧命令，v2 已弃用）
如果 bee run 提示找不到 router.go 或 panic 在 init()，大概率是 conf/app.conf 里 runmode = dev 没生效，检查该文件是否被 gitignore 掉或路径拼错

最易被忽略的一点：Beego v2 的 REST controller 对方法签名零容忍 —— Get() 函数不能带参数，不能有返回值，哪怕多写一个 error 都会导致路由分发失败且无提示。写完立刻用 curl -X GET http://localhost:8080/api/user 验证，别等堆完 CRUD 再测。