在Golang开发中，JSON解析是非常常见的操作，但是解析过程中如果数据格式不符合预期，就会出现各种错误，需要开发者针对性处理。
Golang JSON解析常见错误类型
首先我们需要了解常见的JSON解析错误，方便后续针对性处理，常见的错误主要有以下几类：
- 数据类型不匹配错误：比如JSON中某个字段是字符串类型，但是结构体中定义的字段是int类型，解析时就会报错。
- JSON格式错误：比如JSON字符串缺少引号、括号不匹配、存在多余的逗号等，导致无法正确解析。
- 字段缺失错误：结构体定义的字段在JSON中不存在，或者JSON中的字段名和结构体标签不匹配，会导致字段解析为空值。
- 未知字段错误：JSON中存在结构体没有定义的字段，默认会忽略，但如果开启了严格解析模式，就会报错。
基础解析错误处理方式
Golang的标准库encoding/json的Unmarshal方法会返回错误，我们可以通过判断错误是否为空来处理解析异常，示例如下：
package main
import (
"encoding/json"
"fmt"
)
// 定义解析结构体
type User struct {
Name string `json:"name"`
Age int `json:"age"`
}
func main() {
// 错误的JSON字符串，age字段是字符串类型，和结构体int类型不匹配
jsonStr := `{"name":"张三","age":"20"}`
var user User
// 执行JSON解析
err := json.Unmarshal([]byte(jsonStr), &user)
if err != nil {
// 解析出错时打印错误信息
fmt.Println("JSON解析错误:", err)
return
}
fmt.Printf("解析结果: %+v\n", user)
}上述代码中，因为JSON的age字段是字符串，而结构体中是int类型，所以解析会返回错误，错误信息会提示类型不匹配的具体原因。
自定义解析错误处理逻辑
如果我们需要更精细地处理不同类型的解析错误，可以实现自定义的错误处理逻辑，比如区分不同的错误类型：
package main
import (
"encoding/json"
"fmt"
"strings"
)
type User struct {
Name string `json:"name"`
Age int `json:"age"`
}
// 自定义错误处理函数
func handleJsonError(err error, jsonStr string) {
errMsg := err.Error()
if strings.Contains(errMsg, "invalid character") {
fmt.Println("JSON格式错误，请检查输入的数据格式是否正确")
} else if strings.Contains(errMsg, "cannot unmarshal") {
fmt.Println("字段类型不匹配，请检查结构体字段类型和JSON字段类型是否一致")
} else {
fmt.Println("其他解析错误:", errMsg)
}
}
func main() {
// 格式错误的JSON字符串，缺少闭合引号
jsonStr := `{"name":"张三","age":20`
var user User
err := json.Unmarshal([]byte(jsonStr), &user)
if err != nil {
handleJsonError(err, jsonStr)
return
}
fmt.Printf("解析结果: %+v\n", user)
}严格模式下的解析错误处理
如果我们需要开启严格解析模式，不允许JSON中存在未定义的字段，可以使用Decoder的DisallowUnknownFields方法，示例如下：
package main
import (
"encoding/json"
"fmt"
"strings"
)
type User struct {
Name string `json:"name"`
}
func main() {
// JSON中存在结构体未定义的age字段
jsonStr := `{"name":"李四","age":25}`
decoder := json.NewDecoder(strings.NewReader(jsonStr))
// 开启禁止未知字段模式
decoder.DisallowUnknownFields()
var user User
err := decoder.Decode(&user)
if err != nil {
fmt.Println("严格模式解析错误:", err)
return
}
fmt.Printf("解析结果: %+v\n", user)
}上述代码开启严格模式后，JSON中的age字段是结构体未定义的，所以解析会返回错误，提示存在未知字段。
解析错误排查技巧
当遇到JSON解析错误时，可以按照以下步骤排查：
- 首先检查JSON字符串的格式是否正确，可以使用在线JSON格式校验工具验证。
- 对比结构体字段定义和JSON字段的类型、标签是否匹配，确保字段名、类型一致。
- 查看返回的错误信息的详细描述，根据错误提示定位具体问题。
- 如果是复杂嵌套的JSON，可以逐步解析，先解析外层结构，再处理内层数据。
总结
Golang中处理JSON解析错误的核心是合理判断Unmarshal或者Decode方法返回的错误，结合错误信息和实际需求选择合适的处理方式。日常开发中建议先校验JSON格式的正确性，再定义匹配的结构体，遇到错误时根据错误类型快速定位问题，提升开发效率。