
go的json包只能序列化和反序列化导出(首字母大写)的结构体字段,小写字段因不可见而被忽略,导致解析后结构体为空。
在Go语言中,encoding/json 包遵循严格的可见性规则:只有首字母大写的导出字段(exported fields)才能被 JSON 编解码器访问。若结构体字段以小写字母开头(如 id, refresh_token),它们属于包级私有(unexported),json.Unmarshal 或 json.NewDecoder.Decode() 会完全跳过这些字段——既不报错,也不赋值,最终得到一个“空壳”结构体。
以下是你原始代码的问题核心:
type RefreshTokenData struct {
id string `json:"id"` // ❌ 小写 → 不可导出 → JSON 解析时被忽略
issued_at string `json:"issued_at"`
// ... 其他字段同理
}✅ 正确做法是将所有字段名首字母大写,并通过 json 标签精确映射原始 JSON 的 key 名:
type RefreshTokenData struct {
Id string `json:"id"`
IssuedAt string `json:"issued_at"` // 注意:Go 命名习惯推荐使用驼峰,但标签保持原样
Scope string `json:"scope"`
InstanceURL string `json:"instance_url"`
TokenType string `json:"token_type"`
RefreshToken string `json:"refresh_token"`
IDToken string `json:"id_token"` // 原JSON含此字段,原结构体遗漏!需补充
Signature string `json:"signature"`
AccessToken string `json:"access_token"`
}? 提示:字段名可按 Go 习惯采用 CamelCase(如 IssuedAt, InstanceURL),只要 json tag 中的字符串与 JSON 键完全匹配(区分大小写),就能正确绑定。
完整可运行示例:
立即学习“go语言免费学习笔记(深入)”;
package main
import (
"encoding/json"
"fmt"
"strings"
)
type RefreshTokenData struct {
Id string `json:"id"`
IssuedAt string `json:"issued_at"`
Scope string `json:"scope"`
InstanceURL string `json:"instance_url"`
TokenType string `json:"token_type"`
RefreshToken string `json:"refresh_token"`
IDToken string `json:"id_token"`
Signature string `json:"signature"`
AccessToken string `json:"access_token"`
}
func main() {
tokenResp := `{
"id":"https://google.com",
"issued_at":"1423698767063",
"scope":"full refresh_token",
"instance_url":"https://na15.salesforce.com",
"token_type":"Bearer",
"refresh_token":"2os53__CCU5JX_yZXE",
"id_token":"5jSH0Oqm7Q4fc0xkE9NOvW8cA13U",
"signature":"/599EkGVIBsKPFRNkg+58wZ3Q7AFyclvIGvCrxVeyTo=",
"access_token":"sadfasdfasdfasdfdsa"
}`
var tokenData RefreshTokenData
if err := json.NewDecoder(strings.NewReader(tokenResp)).Decode(&tokenData); err != nil {
fmt.Printf("❌ JSON decode error: %v\n", err)
return
}
fmt.Printf("✅ Success! Refresh token: %s\n", tokenData.RefreshToken)
fmt.Printf(" Access token: %s\n", tokenData.AccessToken)
}? 关键注意事项:
- ✅ 字段必须导出(首字母大写);
- ✅ json tag 中的键名须与 JSON 原文严格一致(包括下划线、大小写);
- ✅ 若 JSON 中存在结构体未定义的字段(如 "id_token"),它会被静默忽略;若需捕获未知字段,可嵌入 map[string]interface{} 或使用 json.RawMessage;
- ✅ 推荐配合 json.Unmarshal 使用时直接传地址:json.Unmarshal([]byte(data), &v),更简洁;
- ⚠️ 避免混用 snake_case 字段名 + json tag —— 虽语法合法,但违背 Go 命名规范,降低可维护性。
遵循导出规则,你的 JSON 解析将立即生效——无错误、有数据、可信赖。










