Beego返回JSON的正确方式

在 Beego 中正确返回 JSON 数据的关键在于理解 Go 的导出规则与 JSON 序列化机制：结构体字段必须首字母大写（即导出）才能被 `encoding/json` 识别，再通过 `json` struct tag 精确控制输出的键名小写形式，否则将意外返回空对象 `{}`；本文直击常见踩坑点，手把手教你用 `this.ServeJson()` 稳定输出符合 API 规范的 JSON，并附上实用注意事项和嵌套数据处理要点，让 Go 开发者一次搞定 Beego 接口响应。

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 数据。

今天关于《Beego返回JSON的正确方式》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！