Go 中 JSON 解析错误排查与修复-Golang-PHP中文网

Go 中 JSON 解析错误排查与修复

碧海醫心

发布： 2025-10-02 16:39:00

原创

755人浏览过

go 中 json 解析错误排查与修复

本文旨在帮助开发者解决 Go 语言中使用 encoding/json 包时遇到的 "panic: invalid character '}' looking for beginning of object key string" 错误。通过分析错误原因，提供修改后的代码示例，并总结 JSON 使用的注意事项，确保程序能够正确解析 JSON 数据。

JSON 解析错误分析

在 Go 语言中使用 encoding/json 包解析 JSON 数据时，如果 JSON 字符串格式不正确，就会触发 panic: invalid character '}' looking for beginning of object key string 错误。这个错误通常表示 JSON 字符串中存在非法的字符，例如多余的 } 括号，导致解析器无法正确识别 JSON 对象的键。

示例代码与错误修复

以下代码示例展示了一个出现 JSON 解析错误的场景，并提供了修复后的代码。

错误代码：

package main

import (
    "encoding/json"
    "fmt"
)

func insertEntry(j *map[string]interface{}, entry string) {
    err := json.Unmarshal([]byte(entry), j)
    if err != nil {
        panic(err)
    }

}

func main() {
    c1 := "{" +
        `"mw" : 42.0922,` +
        `"ΔfH°gas" : {` +
        `   "value" : 372.38,` +
        `   "units" : "kJ/mol"` +
        `},` +
        `"S°gas" : {` +
        `   "value" : 216.81,` +
        `   "units" : "J/mol×K"` +
        `},` +
        `"index" : [` +
        `   {"name" : "mw", "value" : 42.0922},` +
        `   {"name" : "ΔfH°gas", "value" : 372.38},` +
        `   {"name" : "S°gas", "value" : 216.81}` +
        `]` +
        `}`

    c2 := "{" +
        `"name" : "silicon",` +
        `"mw" : 32.1173,` +
        `}` +
        `"index" : [` +
        `   {"name" : "mw", "value" : 32.1173}` +
        `]` +
        `}`

    var m map[string]interface{}

    insertEntry(&m, c1)
    insertEntry(&m, c2)
    chemical := m["ΔfH°gas"].(map[string]interface{})
    fmt.Printf("value: %s\n", chemical["value"].(string))
    fmt.Printf("units: %s\n", chemical["units"].(string))
}

登录后复制

在这个例子中，c2 变量包含了错误的 JSON 格式。在 "mw" : 32.1173, 之后有一个多余的 }，导致解析失败。

Symanto Text Insights

基于心理语言学分析的数据分析和用户洞察

查看详情

修复后的代码：

package main

import (
    "encoding/json"
    "fmt"
)

func insertEntry(j *map[string]interface{}, entry string) {
    err := json.Unmarshal([]byte(entry), j)
    if err != nil {
        panic(err)
    }

}

func main() {
    c1 := `{"mw": 42.0922, "ΔfH°gas": {"value": 372.38, "units": "kJ/mol"}, "S°gas": {"value": 216.81, "units": "J/mol×K"}, "index": [{"name": "mw", "value": 42.0922}, {"name": "ΔfH°gas", "value": 372.38}, {"name": "S°gas", "value": 216.81}]}`

    c2 := `{"name": "silicon", "mw": 32.1173, "index": [{"name": "mw", "value": 32.1173}]}`

    var m map[string]interface{}

    insertEntry(&m, c1)
    insertEntry(&m, c2)

    // 类型断言前进行检查
    if chemical, ok := m["ΔfH°gas"].(map[string]interface{}); ok {
        if value, ok := chemical["value"].(float64); ok {
            fmt.Printf("value: %f\n", value)
        } else {
            fmt.Println("Error: value is not a float64")
        }
        if units, ok := chemical["units"].(string); ok {
            fmt.Printf("units: %s\n", units)
        } else {
            fmt.Println("Error: units is not a string")
        }
    } else {
        fmt.Println("Error: ΔfH°gas is not a map[string]interface{}")
    }
}

登录后复制

关键修改：

移除了 c2 字符串中多余的 }。
统一使用反引号`定义JSON字符串，避免转义字符的困扰。
添加了类型断言前的检查，确保程序不会因为类型不匹配而崩溃。注意，chemical["value"] 的类型应该是 float64 而不是 string。

JSON 使用注意事项

JSON 格式验证： 在使用 json.Unmarshal 解析 JSON 字符串之前，务必验证 JSON 格式的正确性。可以使用在线 JSON 校验工具或 IDE 的 JSON 格式化功能来检查 JSON 字符串是否合法。
类型断言： 使用 map[string]interface{} 存储 JSON 数据时，需要进行类型断言才能访问具体的值。在进行类型断言之前，最好先检查类型是否匹配，以避免 panic。
错误处理： json.Unmarshal 函数会返回一个 error 对象。在实际应用中，应该对这个 error 对象进行处理，例如记录日志或返回错误信息，而不是直接 panic。
字符串定义方式： 使用反引号 ` 定义包含特殊字符的字符串，可以避免大量的转义字符，提高代码可读性。
数据类型匹配： 确保从 JSON 中提取的数据类型与代码中期望的数据类型一致。例如，如果 JSON 中某个字段的值是数字，那么在代码中应该使用 float64 或 int 类型来接收。