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 类型可见性机制的严格体现。
