
Beego 中控制器返回空 JSON(如 {})通常是因为结构体字段未导出,导致 encoding/json 无法序列化;只需将字段首字母大写并配合 json 标签即可解决。
beego 中控制器返回空 json(如 `{}`)通常是因为结构体字段未导出,导致 `encoding/json` 无法序列化;只需将字段首字母大写并配合 `json` 标签即可解决。
在 Beego 中使用 this.ServeJson() 返回结构体数据时,底层依赖 Go 标准库的 encoding/json 包进行序列化。而该包仅能访问并序列化导出(exported)字段——即字段名必须以大写字母开头。若字段为小写(如 s、d),则属于未导出字段,会被自动忽略,最终输出空对象 {}。
✅ 正确做法是:
- 将结构体字段名改为大写(如 S, D)以满足 Go 的导出规则;
- 使用 json struct tag 显式指定 JSON 输出中的键名(保持小写语义);
- 确保结构体本身为导出类型(首字母大写,如 ErrorJson 已符合)。
修正后的代码如下:
type ErrorJson struct {
S string `json:"s"`
D string `json:"d"`
}
func (this *ErrorController) Get() {
responseJson := ErrorJson{
S: "asdf",
D: "qwer",
}
this.Data["json"] = responseJson
this.ServeJson()
}
此时访问 /api 将正确返回:
{"s":"asdf","d":"qwer"}
⚠️ 注意事项:
- ServeJson() 默认会设置 Content-Type: application/json 并调用 json.Marshal(),无需手动处理;
- 若需兼容 nil 字段或控制空值行为,可传入额外参数,例如 this.ServeJson(false, false, "UTF-8")(依次表示:不格式化、不安全输出、编码);
- 所有嵌套结构体、切片、map 中的字段也需遵循相同导出规则,否则同样会被忽略;
- 推荐为结构体添加 json tag 并统一使用小写键名,兼顾 API 规范性与 Go 语言约定。
通过确保字段导出 + 合理使用 struct tag,即可稳定、清晰地从 Beego 控制器输出预期 JSON 数据。











