c.JSON() 是 Gin 返回 JSON 的唯一推荐方式,因其自动设置 Content-Type、调用 json.Marshal() 并处理错误;手写易漏 Header、忽略编码失败或传入未导出字段导致前端解析失败。

c.JSON() 是 Gin 返回 JSON 的唯一推荐方式,别自己拼 JSON 字符串或手写 json.Marshal() + c.Data() —— 90% 的 Content-Type 错误、前端解析失败、下载弹窗都源于此。
为什么必须用 c.JSON() 而不是手写序列化
它自动设置 Content-Type: application/json,内部调用 json.Marshal() 并处理错误;手写容易漏 Header、忽略编码失败、或把 nil 当空字符串传给前端。常见现象:curl 返回纯文本、浏览器弹下载框、response.json() 报 Unexpected token —— 基本就是没设对类型或序列化 panic 了。
以下操作必须避免:
- 用
json.Marshal(data)得到字节切片后,再调c.Data(200, "application/json", b) - 在响应前手动调
c.Header("Content-Type", "application/json")然后写 raw body - 把未导出字段(小写开头)或函数值(如
func() {})直接塞进响应结构体
c.JSON() 传参时字段丢失的真正原因
不是类型问题(int64 完全支持),而是 Go 的导出规则 + JSON tag 双重生效。字段名首字母小写 → 非导出 → encoding/json 直接跳过,无论有没有 tag。
比如这个结构体:
type User struct {
id int64 `json:"id"` // ❌ 小写 id → 不导出 → 序列化时消失
Name string `json:"name"`
}
正确写法是:
exa-js 是 Exa 官方 JavaScript 软件开发工具包,Exa 是一个为 AI 工作流构建的网络搜索 API。它为代理提供了一种具体的方式来搜索网络、检索页面内容,并从代码中生成有来源的答案,而不是手动拼接原始 HTTP 调用。
type User struct {
ID int64 `json:"id"` // ✅ 大写 ID → 导出 → 正常输出
Name string `json:"name"`
}
关键点:
- 结构体名和字段名都必须首字母大写(导出)
-
json:"xxx"tag 控制 key 名,不解决导出性问题 - 字段含
sync.Mutex、chan、func或未导出嵌套 struct → 运行时 panic,提前用json.Marshal(data)单测可快速暴露
统一响应格式封装时最容易踩的坑
定义 Response 结构体后,封装 Success/Fail 函数,但实际落地时高频出错:
-
Code字段用string类型 —— 前端switch(code)失败,必须是int -
Data字段声明为interface{},但传入func() {}或map[string]any{"x": time.Now()}—— 后者会 panic,因time.Time默认不可序列化(除非注册 encoder) - 在
defer里调response.Fail(c, ...)—— 响应头已 flush,触发write on flushed bodypanic - 校验失败后只调
Fail400,但没加return—— handler 继续执行,可能重复写响应或 DB 查询 - 错误码散落在各处写
1001、"参数错误",没收敛到errcode包 —— 后期改码、查日志、前端映射全乱套
时间字段和敏感字段的 JSON 输出控制
数据库模型直接当响应体返回?大概率出事。重点控制两类字段:
- 敏感字段(密码哈希、token、内部 ID):用
json:"-"彻底屏蔽,零运行时开销,编译期确定 - 可选字段(手机号、头像 URL):用
json:",omitempty",值为空时不输出,避免前端看到"phone": "" - 时间字段:别用
time.Time直接序列化(默认输出 RFC3339,带时区且字符串长);统一转成int64毫秒时间戳,或预定义JSONMarshal方法
例如:
type User struct {
ID int64 `json:"id"`
PasswordHash string `json:"-"` // 绝不响应
Phone string `json:"phone,omitempty"`
CreatedAt time.Time `json:"-"` // 屏蔽原始 time.Time
CreatedAtMs int64 `json:"created_at_ms"` // 手动赋值:u.CreatedAtMs = u.CreatedAt.UnixMilli()
}
复杂点不在语法,而在边界意识:每个响应结构体都要明确「谁消费」「哪些字段该露」「哪些字段该藏」——不是写完 struct 就完事,得逐字段过一遍。
golang免费学习笔记(深入):立即使用
在学习笔记中,你将探索golang的核心概念和高级技巧!










