如何在 Go 中正确解析 JSON 数据以填充结构体

go 的 `encoding/json` 包仅能序列化和反序列化导出（首字母大写）的结构体字段；若字段为小写（未导出），json 解析将静默失败，导致结构体字段为空。

在 Go 中解析 JSON 时，一个常见却容易被忽视的陷阱是：结构体字段必须是导出的（即首字母大写），否则 json.Unmarshal 或 json.Decoder.Decode 将无法访问这些字段——即使解析过程不报错，字段值也始终为空字符串、零值或 nil。

这是因为 Go 的反射机制（encoding/json 依赖它）仅能访问导出标识符（符合 Go 规范中“导出标识符”定义：首字母为 Unicode 大写字母）。小写字段（如 id, refresh_token）属于包级私有，对 json 包不可见，因此反序列化时被直接忽略。

✅ 正确做法是：将结构体字段名改为大驼峰（PascalCase）命名，并通过 json 标签精确映射原始 JSON 键名：

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"`        // 注意：原 JSON 含此字段，原结构体遗漏！
    Signature     string `json:"signature"`
    AccessToken   string `json:"access_token"`
}

? 补充说明：原始示例 JSON 中包含 "id_token" 字段，但原结构体未定义对应字段，这会导致该字段丢失。务必确保结构体字段与 JSON 键一一覆盖（或使用 map[string]interface{} 动态处理未知字段）。

完整可运行示例：

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)
}

? 关键注意事项：

• ❌ 不要使用小写字段名（如 refresh_token）试图匹配 JSON 键——它不会生效；
• ✅ 命名建议采用 Go 惯例：字段名用 CamelCase（如 RefreshToken），并通过 json:"refresh_token" 标签保持与 JSON 兼容；
• ⚠️ 若 JSON 中存在结构体未定义的字段（如额外的 "user_id"），默认会被忽略；如需捕获所有字段，可嵌入 json.RawMessage 或使用 map[string]any；
• ? 开发时建议添加 json:"required" 标签并配合自定义校验（如使用 go-playground/validator）提升健壮性。

遵循导出规则，是 Go 中 JSON 反序列化的基石——看似微小的大小写差异，实则是 Go 类型可见性机制的严格体现。