Go 的 json.Unmarshal 会严格遵循 JSON 规范：双引号包裹的 "1" 是字符串，而非数字；只有不带引号的 1 才被解析为浮点数或整数。理解这一区别是避免类型错误的关键。
go 的 `json.unmarshal` 会严格遵循 json 规范：双引号包裹的 `"1"` 是字符串，而非数字；只有不带引号的 `1` 才被解析为浮点数或整数。理解这一区别是避免类型错误的关键。
在 Go 中使用 encoding/json 解析 JSON 数据时，一个常见误区是将带引号的 "1" 误认为可自动转换为数值类型（如 float64 或 int）。但实际上，JSON 规范明确规定：带双引号的值是字符串（string），无引号的才是数字（number）。因此，json.Unmarshal 不会做隐式类型转换——它尊重原始 JSON 的语义结构。
✅ 正确示例（合法 JSON 数字）：
package main
import (
"encoding/json"
"fmt"
)
func main() {
data := []byte(`{"value": 1}`) // 注意：1 没有引号
var v struct {
Value float64 `json:"value"`
}
if err := json.Unmarshal(data, &v); err != nil {
panic(err)
}
fmt.Printf("Value: %v (type: %T)\n", v.Value, v.Value) // 输出：Value: 1 (type: float64)
}❌ 错误示例（JSON 字符串，无法直接解码为数字）：
data := []byte(`{"value": "1"}`) // "1" 是字符串，不是数字
var v struct {
Value float64 `json:"value"`
}
err := json.Unmarshal(data, &v) // ❌ 返回 error: json: cannot unmarshal string into Go struct field Value of type float64? 解决方案取决于实际需求：
-
若上游数据确实以字符串形式发送数字（如 "1"、"3.14"），可定义字段为 string，再手动转换：
type Payload struct { Value string `json:"value"` } // 解析后：v, _ := strconv.ParseFloat(p.Value, 64) -
或使用自定义 UnmarshalJSON 方法实现柔性解析（支持字符串/数字双格式）：
type FlexibleNumber float64 func (f *FlexibleNumber) UnmarshalJSON(data []byte) error { // 先尝试解析为数字 var num float64 if err := json.Unmarshal(data, &num); err == nil { *f = FlexibleNumber(num) return nil } // 再尝试解析为字符串并转数字 var s string if err := json.Unmarshal(data, &s); err != nil { return err } n, err := strconv.ParseFloat(s, 64) if err != nil { return fmt.Errorf("cannot parse %q as number", s) } *f = FlexibleNumber(n) return nil }
⚠️ 注意事项：
- 不要依赖 json.Unmarshal 自动进行字符串→数字转换，这违反 JSON 类型安全原则；
- 生产环境应明确约定 API 的 JSON Schema（例如 Swagger/OpenAPI），避免歧义字段；
- 使用 json.RawMessage 或第三方库（如 github.com/mitchellh/mapstructure）可增强灵活性，但需权衡可维护性与性能。
总之，Go 的 JSON 解析器设计严谨而明确：字符串就是字符串，数字就是数字。正确区分二者，是写出健壮 JSON 处理逻辑的第一步。
