本文介绍一种专业、健壮且符合 Go 惯用法的方案：通过自定义类型实现 json.UnmarshalJSON，使结构体字段能无缝兼容 "123.45" 和 123.45 两种 JSON 数字表示形式，避免运行时错误和正则预处理等不安全手段。
本文介绍一种专业、健壮且符合 go 惯用法的方案：通过自定义类型实现 `json.unmarshaljson`，使结构体字段能无缝兼容 `"123.45"` 和 `123.45` 两种 json 数字表示形式，避免运行时错误和正则预处理等不安全手段。
在与第三方 JSON API 交互时，开发者常遇到一个棘手问题：同一字段的数值有时以原始数字（如 {"price": 99.99}）出现，有时却被意外包裹在双引号中（如 {"price": "99.99"}）。Go 标准库的 encoding/json 包对此缺乏原生支持——json:",string" 标签仅接受带引号字符串，对原始数字会报错；而省略该标签则无法解析字符串形式的数字。硬编码多类型分支或反射处理不仅冗余，还破坏类型安全性。
推荐方案：定义可兼容解析的自定义浮点类型
最符合 Go 设计哲学的方式是创建一个新类型（如 jsonFloat64），并为其实现 UnmarshalJSON 方法，使其能智能识别输入是否为带引号字符串，并统一转换为 float64 值：
type jsonFloat64 float64
// UnmarshalJSON 支持解析原始数字（123.45）和带引号数字（"123.45"）
func (f *jsonFloat64) UnmarshalJSON(data []byte) error {
// 检查是否为带引号字符串："xxx"
if len(data) >= 2 && data[0] == '"' && data[len(data)-1] == '"' {
data = data[1 : len(data)-1] // 剥离引号
}
var tmp float64
if err := json.Unmarshal(data, &tmp); err != nil {
return fmt.Errorf("failed to unmarshal JSON number: %w", err)
}
*f = jsonFloat64(tmp)
return nil
}
// MarshalJSON 保持标准序列化行为（输出不带引号的原始数字）
func (f jsonFloat64) MarshalJSON() ([]byte, error) {
return json.Marshal(float64(f))
}使用时，只需将结构体字段声明为 jsonFloat64 类型即可：
type Product struct {
Price jsonFloat64 `json:"price"`
Discount jsonFloat64 `json:"discount"`
}
func main() {
// 两种格式均能成功解析
json1 := `{"price": 89.99, "discount": 15.5}`
json2 := `{"price": "89.99", "discount": "15.5"}`
var p1, p2 Product
json.Unmarshal([]byte(json1), &p1) // ✅
json.Unmarshal([]byte(json2), &p2) // ✅
fmt.Printf("Price: %.2f, Discount: %.1f\n", float64(p1.Price), float64(p2.Discount))
// 输出：Price: 89.99, Discount: 15.5
}✅ 优势总结：
- 类型安全：编译期检查，无 interface{} 或 map[string]interface{} 的运行时风险；
- 零依赖：仅依赖标准库，无第三方包引入；
- 可扩展性强：同理可派生 jsonInt64、jsonUint 等类型；
- 性能优异：避免正则匹配、字符串遍历等 O(n) 预处理开销。
⚠️ 注意事项：
- 上述 UnmarshalJSON 对引号位置严格校验（首尾必须为 "），不处理空格（如 " 123.45 "）或 Unicode 空白符。如需更宽松解析，可在剥离引号前调用 strings.TrimSpace(string(data[1:len(data)-1])) 并重新编码为 []byte；
- 切勿对 float64 原类型直接实现方法（Go 不允许为非本地类型定义方法），务必通过 type jsonFloat64 float64 创建新类型；
- 若需支持 null 值，请改用 *jsonFloat64 或结合 sql.NullFloat64 思路增强空值语义。
该方案已被广泛应用于金融、电商等对 API 兼容性要求严苛的生产环境，是处理“非标 JSON 数字”问题的业界推荐实践。
