bee api 命令可直接生成精简的 RESTful 服务骨架,仅含 controllers/、models/、routers/ 等必要目录,自动配置 autorender=false 并注册路由入口;而 bee new 生成含 views/ 和 static/ 的全功能 Web 项目,不适用于纯 API 场景。

Beego 的 bee api 命令能直接生成可运行的 RESTful 服务骨架,跳过手动建目录、配路由、写空控制器这些重复劳动——只要数据库连得上,bee generate 甚至能全自动产出 Model/Controller/Router 三件套。
用 bee api 初始化项目,别用 bee new
API 服务不需要模板渲染和静态资源目录,bee new 生成的是全功能 Web 项目(含 views/、static/),而 bee api 精简掉这些,只留 controllers/、models/、routers/ 和必要配置:
-
bee api myapi会创建标准 API 项目结构,conf/app.conf中默认关闭了autorender = false,避免 JSON 响应被模板引擎干扰 - 生成的
main.go已调用beego.AddAPP(&App{}),不需手动注册路由入口 - 如果执行
bee new myapi后再删views/和关autorender,容易漏改controllers/default.go里的c.TplName赋值,导致 500 错误
RESTful 路由注册必须用 beego.RESTRouter,不是 beego.Router
beego.Router 是基础路径映射,不自动绑定 HTTP 方法到控制器方法;beego.RESTRouter 才按 REST 规范把 GET /users → GetAll()、POST /users → Post()、GET /users/1 → GetOne() 等一一对应:
- 在
routers/router.go中写beego.RESTRouter("/api/users", &controllers.UserController{}) -
UserController必须嵌入beego.Controller,且方法名严格为Get()、GetAll()、Post()、Put()、Delete()、GetOne()等,大小写和拼写错一个就 404 - 若混用
beego.Router写/api/users,所有方法都只能走URL匹配,还得自己在控制器里用c.Ctx.Input.Method判断请求类型,失去 REST 语义
自动生成 CRUD 代码前,先装驱动并验证数据库连接
bee generate 依赖数据库元信息反向建模,连不上库或权限不足会导致静默失败,只生成空文件或报错 invalid connection:
- MySQL 需提前执行
go get github.com/go-sql-driver/mysql,PostgreSQL 对应github.com/lib/pq - 连接字符串格式必须正确:
root:password@tcp(127.0.0.1:3306)/dbname?charset=utf8mb4&parseTime=True,少一个&或参数名拼错(如写成charser)都会连不上 - 运行
bee generate model -driver=mysql -conn="..." -table=user前,先用mysql -h127.0.0.1 -P3306 -uroot -p dbname手动登录确认库可达
ServeJSON() 的坑:Content-Type 和中文乱码
直接调 c.ServeJSON() 默认返回 Content-Type: application/json; charset=UTF-8,但若控制器里提前调了 c.Data["json"] = xxx 又没清空 c.Data["xml"] 或其他字段,可能触发 Beego 内部的类型协商逻辑,返回 text/plain 导致前端解析失败:
- 确保只设
c.Data["json"],不要同时设c.Data["xml"]或c.Data["yaml"] - 中文字段值必须是 Go 字符串(
string类型),不能是[]byte或未转义的 raw JSON 字符串,否则ServeJSON()会原样输出字节流,浏览器看到乱码 - 如需自定义状态码,用
c.Abort("201")配合c.ServeJSON(),别用c.Ctx.Output.SetStatus(201)—— 后者在ServeJSON()内部会被覆盖
最易被忽略的是 conf/app.conf 里的 runmode = dev:生产环境不改这个,日志全量输出+热编译开着,CPU 持续飙高还查不出原因。


















