Beego开发REST API的核心是让Controller正确响应HTTP方法并跳过模板渲染；需删除controllers/base.go、使用RESTRouter或手动路由映射、用ServeJSON而非Render、确保方法签名无参数无返回值。
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 分发逻辑。
立即学习“go语言免费学习笔记（深入）”；
正确做法只有两种：
- 用
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 再测。
