本文旨在帮助 Go 开发者解决 JSON 解析过程中遇到的 panic: invalid character '}' looking for beginning of object key string 错误。通过分析错误原因，提供正确的 JSON 格式示例，并给出调试建议，帮助开发者避免类似问题的发生，提高代码的健壮性。
JSON（JavaScript Object Notation）作为一种轻量级的数据交换格式，在 Go 语言中被广泛使用。encoding/json 包提供了方便的 JSON 序列化和反序列化功能。然而，当 JSON 格式不正确时，程序可能会抛出 panic 异常，导致程序崩溃。本文将深入探讨 panic: invalid character '}' looking for beginning of object key string 错误的常见原因以及如何解决。
错误原因分析
panic: invalid character '}' looking for beginning of object key string 错误通常发生在 JSON 反序列化过程中，意味着 JSON 字符串的格式不符合规范。具体来说，错误信息表明解析器在期望找到对象键（key）的开头时，遇到了一个非法的字符 }。这通常是因为：
- JSON 结构不完整或错误： 例如，缺少引号、冒号、逗号等分隔符，或者括号不匹配。
- 多余的字符： JSON 字符串中包含了不属于 JSON 结构的字符，例如多余的 }。
- 字符串未正确转义： JSON 字符串中的特殊字符（如引号）未进行转义。
示例与修复
以下代码示例展示了可能导致该错误的情况，并提供了修复方案：
错误示例：
使用约定式提交（Conventional Commits）生成标准化的 Git 提交信息。适用于以下场景： (1) 暂存更改时需要提交信息； (2) 审查 diff 时希望获得结构化摘要； (3) 编写 PR 描述或变更日志（changelog）条目； (4) 用户明确要求“为本次更改编写提交信息”。 该功能会分析已暂存/未暂存的 diff，并生成按类型（type）划分范围的提交信息。
package main
import (
"encoding/json"
"fmt"
)
func main() {
invalidJSON := `{
"name" : "silicon",
"mw" : 32.1173,
}
"index" : [
{
"name" : "mw",
"value" : 32.1173
}
]
}`
var data map[string]interface{}
err := json.Unmarshal([]byte(invalidJSON), &data)
if err != nil {
panic(err)
}
fmt.Println(data)
}运行上述代码将会抛出 panic: invalid character '}' looking for beginning of object key string 错误。
修复方案：
仔细检查 JSON 字符串，移除多余的 }，并将 index 字段合并到主对象中。
package main
import (
"encoding/json"
"fmt"
)
func main() {
validJSON := `{
"name": "silicon",
"mw": 32.1173,
"index": [
{
"name": "mw",
"value": 32.1173
}
]
}`
var data map[string]interface{}
err := json.Unmarshal([]byte(validJSON), &data)
if err != nil {
panic(err)
}
fmt.Println(data)
}修改后的代码将 JSON 字符串修正为符合规范的格式，成功解析并输出结果。
注意事项与最佳实践
- 使用 JSON 验证工具： 在处理 JSON 字符串之前，可以使用在线 JSON 验证工具（例如 JSONLint）检查其格式是否正确。
- 仔细检查错误信息： json.Unmarshal 函数返回的错误信息通常包含错误发生的具体位置，可以帮助快速定位问题。
- 使用结构体进行反序列化： 尽量使用预定义的结构体进行 JSON 反序列化，而不是 map[string]interface{}。这可以提高代码的可读性和类型安全性，并减少出错的可能性。例如：
type Chemical struct {
Name string `json:"name"`
Mw float64 `json:"mw"`
Index []struct {
Name string `json:"name"`
Value float64 `json:"value"`
} `json:"index"`
}
func main() {
validJSON := `{
"name": "silicon",
"mw": 32.1173,
"index": [
{
"name": "mw",
"value": 32.1173
}
]
}`
var chemical Chemical
err := json.Unmarshal([]byte(validJSON), &chemical)
if err != nil {
panic(err)
}
fmt.Println(chemical)
}- 处理错误： 始终检查 json.Unmarshal 函数返回的错误，并进行适当的处理，例如记录日志或返回错误信息，而不是直接 panic。
总结
panic: invalid character '}' looking for beginning of object key string 错误是 Go 语言 JSON 解析中常见的错误。通过理解错误原因，使用 JSON 验证工具，仔细检查 JSON 字符串，并使用结构体进行反序列化，可以有效地避免此类错误的发生，提高代码的健壮性和可靠性。记住，良好的 JSON 格式是成功解析的关键。
