本文旨在帮助开发者解决 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, 之后有一个多余的 }，导致解析失败。
修复后的代码：
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 类型来接收。
总结
通过本文的分析和示例，相信读者已经掌握了如何排查和修复 Go 语言中常见的 JSON 解析错误。在实际开发中，务必注意 JSON 格式的正确性、类型断言和错误处理，以确保程序的稳定性和可靠性。
