讲师中心 微信公众号
首页
文章
后端开发 web前端 数据库 开发工具 php框架 常见问题 人工智能 Java 系统教程 电脑教程 硬件教程 手机教程 软件教程 游戏教程 自媒体 新闻
专题
后端开发 web前端 数据库 开发工具 php框架 人工智能 Java 系统教程 电脑教程 硬件教程 手机教程 软件教程 游戏教程 新闻
AI工具
AI 聊天问答 Agent智能体 AI 文本写作 AI 绘画作图 AI 设计工具 AI 视频创作 AI 音频制作 AI 办公学习 AI 编程开发 Prompt指令
学习
大前端 后端开发 数据库 移动端 运维开发 计算机基础
编程手册
大前端 后端开发 数据库 移动端 运维开发 计算机基础
下载
js特效 网站源码 工具下载 类库下载 网站素材 学习资源 插件扩展 手机游戏
最近更新
当前位置：首页 > 后端开发 > Golang >

正文

0

0

Go语言中复杂JSON字符串的解析与json.Unmarshal指针要求

DDD

DDD

发布时间：2025-09-29 14:02:37

|

1013人浏览过

|

来源于php中文网

原创

Go语言中复杂JSON字符串的解析与json.Unmarshal指针要求

本文深入探讨了在Go语言中如何正确解析嵌套的JSON字符串。核心在于理解encoding/json包中Unmarshal函数的工作原理，特别是它需要接收目标数据结构的指针才能成功修改其内容。通过一个多层嵌套的配置JSON示例，文章演示了如何定义合适的Go类型（包括结构体和嵌套map）来映射JSON结构，并纠正了常见的non-pointer错误，提供了详细的解析步骤和最佳实践。

理解复杂JSON数据结构

在go语言中处理json数据时，首先要准确理解json本身的结构。本教程将使用以下复杂的json字符串作为示例，它代表了一个多环境（development、production）的服务配置：

{
  "development": {
    "connector": [
      { "id": "connector-server-1", "host": "127.0.0.1", "port": 4050, "wsPort": 3050 },
      { "id": "connector-server-2", "host": "127.0.0.1", "port": 4051, "wsPort": 3051 },
      { "id": "connector-server-3", "host": "127.0.0.1", "port": 4052, "wsPort": 3052 }
    ],
    "chat": [
      { "id": "chat-server-1", "host": "127.0.0.1", "port": 6050 },
      { "id": "chat-server-2", "host": "127.0.0.1", "port": 6051 },
      { "id": "chat-server-3", "host": "127.0.0.1", "port": 6052 }
    ],
    "gate": [
      { "id": "gate-server-1", "host": "127.0.0.1", "wsPort": 3014 }
    ]
  },
  "production": {
    "connector": [
      { "id": "connector-server-1", "host": "127.0.0.1", "port": 4050, "wsPort": 3050 },
      { "id": "connector-server-2", "host": "127.0.0.1", "port": 4051, "wsPort": 3051 },
      { "id": "connector-server-3", "host": "127.0.0.1", "port": 4052, "wsPort": 3052 }
    ],
    "chat": [
      { "id": "chat-server-1", "host": "127.0.0.1", "port": 6050 },
      { "id": "chat-server-2", "host": "127.0.0.1", "port": 6051 },
      { "id": "chat-server-3", "host": "127.0.0.1", "port": 6052 }
    ],
    "gate": [
      { "id": "gate-server-1", "host": "127.0.0.1", "wsPort": 3014 }
    ]
  }
}

这个JSON结构包含两层嵌套的键值对：

  1. 顶层键: development 和 production，代表不同的部署环境。
  2. 第二层键: connector、chat、gate，代表不同类型的服务。
  3. 值: 每个服务类型下是一个服务实例的数组，每个实例是一个包含 id、host、port、wsPort 等字段的对象。

定义Go数据结构

为了将上述JSON数据解析到Go程序中，我们需要定义匹配其结构的Go类型。

首先，定义一个Service结构体来表示JSON中的单个服务实例：

package config

import (
    "encoding/json"
    "errors"
    "fmt"
    "io/ioutil" // 在Go 1.16+中推荐使用os.ReadFile
    "log"
    "sync"
)

// Service 结构体定义了单个服务实例的属性
type Service struct {
    Id        string `json:"id"`
    Host      string `json:"host"`
    Port      uint   `json:"port"`
    QueryPort uint   `json:"queryPort"` // JSON中可能不存在，会保留零值
    WsPort    uint   `json:"wsPort"`
    // ServiceType string // 此字段在JSON中不存在，如果需要可手动赋值或通过其他方式获取
}

// Config 结构体（可选，用于更高层级的配置管理）
type Config struct {
    Services []Service
    Master   Service
    Mutex    sync.RWMutex
}

这里需要注意：

立即学习“go语言免费学习笔记（深入）”；

  • json:"fieldName" 标签：这些标签告诉encoding/json包如何将JSON字段映射到Go结构体字段。如果JSON字段名与Go结构体字段名不一致，必须使用此标签。
  • Port、QueryPort、WsPort 使用 uint 类型，以匹配JSON中可能出现的无符号整数。
  • QueryPort 和 ServiceType 字段在示例JSON中不存在。当JSON中缺少结构体字段时，json.Unmarshal 会将这些字段设置为其类型的零值（例如，uint为0，string为空字符串）。

接下来，为了匹配JSON的整体嵌套结构（环境 -> 服务类型 -> 服务实例列表），我们可以使用一个嵌套的map类型：

// 目标类型：map[环境名称]map[服务类型][]Service
var configs map[string]map[string][]Service

错误的解析尝试与原因分析

假设我们尝试按照以下方式解析JSON文件：

func LoadServers(filepath string) (*Config, error) {
    content, err := ioutil.ReadFile(filepath)
    if err != nil {
        return nil, err
    }

    configs := make(map[string]map[string][]Service, 0)
    // 错误的用法：直接传递configs变量
    err = json.Unmarshal(content, configs) // 错误发生在这里
    if err != nil {
        log.Printf("JSON Unmarshal error: %v", err)
        return nil, err
    }

    // ... 后续处理configs ...
    return nil, errors.New("not implemented") // 示例代码，实际需返回Config
}

运行上述代码，Go编译器或运行时会抛出以下错误：

AIPAI
AIPAI

AI视频创作智能体

下载 
json: Unmarshal(non-pointer map[string]map[string][]config.Service)

原因分析： json.Unmarshal 函数的签名是 func Unmarshal(data []byte, v interface{}) error。其中 v 参数的类型是 interface{}。encoding/json 包在内部需要通过反射来修改 v 所指向的值。在Go语言中，要修改一个变量的值，必须传递该变量的地址（即指针）。如果传递的是一个非指针类型的值，函数内部将无法修改原始变量，而只能修改其副本。因此，json.Unmarshal 强制要求 v 必须是一个指针类型。

configs 变量是一个 map 类型，它本身是一个值类型（尽管其内部数据是引用类型）。当我们将 configs 直接传递给 Unmarshal 时，实际上是传递了 configs 的一个副本。Unmarshal 尝试修改这个副本，但无法影响到函数外部的原始 configs 变量。为了解决这个问题，我们需要传递 configs 变量的内存地址。

正确的解析方法

解决 non-pointer 错误非常简单，只需在将 configs 变量传递给 json.Unmarshal 时，使用 & 运算符获取其地址：

func LoadServersCorrect(filepath string) (map[string]map[string][]Service, error) {
    content, err := ioutil.ReadFile(filepath)
    if err != nil {
        return nil, fmt.Errorf("读取文件失败: %w", err)
    }

    configs := make(map[string]map[string][]Service) // make时可以不指定容量
    // 正确的用法：传递configs变量的地址
    err = json.Unmarshal(content, &configs) // 注意这里的 '&' 符号
    if err != nil {
        return nil, fmt.Errorf("JSON Unmarshal失败: %w", err)
    }

    return configs, nil
}

通过传递 &configs，json.Unmarshal 就能通过指针访问并修改 configs 变量的实际内容，从而成功将JSON数据解析到其中。

完整示例代码

下面是一个完整的Go程序，演示了如何将上述JSON字符串解析到 map[string]map[string][]Service 中，并打印解析结果：

package main

import (
    "encoding/json"
    "fmt"
    "io/ioutil" // 在Go 1.16+中推荐使用os.ReadFile
    "log"
    "os"
)

// Service 结构体定义了单个服务实例的属性
type Service struct {
    Id        string `json:"id"`
    Host      string `json:"host"`
    Port      uint   `json:"port,omitempty"` // omitempty表示如果值为零则不输出到JSON，但解析时仍会填充
    QueryPort uint   `json:"queryPort,omitempty"`
    WsPort    uint   `json:"wsPort,omitempty"`
}

// simulateConfigFile 创建一个模拟的配置文件
func simulateConfigFile(filename string, content string) error {
    return ioutil.WriteFile(filename, []byte(content), 0644)
}

func main() {
    jsonString := `{
    "development":{
        "connector":[
             {"id":"connector-server-1", "host":"127.0.0.1", "port":4050, "wsPort":3050},
             {"id":"connector-server-2", "host":"127.0.0.1", "port":4051, "wsPort":3051},
             {"id":"connector-server-3", "host":"127.0.0.1", "port":4052, "wsPort":3052}
         ],
        "chat":[
             {"id":"chat-server-1", "host":"127.0.0.1", "port":6050},
             {"id":"chat-server-2", "host":"127.0.0.1", "port":6051},
             {"id":"chat-server-3", "host":"127.0.0.1", "port":6052}
        ],
        "gate":[
         {"id": "gate-server-1", "host": "127.0.0.1", "wsPort": 3014}
    ]
    },
    "production":{
       "connector":[
             {"id":"connector-server-1", "host":"127.0.0.1", "port":4050, "wsPort":3050},
             {"id":"connector-server-2", "host":"127.0.0.1", "port":4051, "wsPort":3051},
             {"id":"connector-server-3", "host":"127.0.0.1", "port":4052, "wsPort":3052}
         ],
        "chat":[
             {"id":"chat-server-1", "host":"127.0.0.1", "port":6050},
             {"id":"chat-server-2", "host":"127.0.0.1", "port":6051},
             {"id":"chat-server-3", "host":"127.0.0.1", "port":6052}
        ],
        "gate":[
         {"id": "gate-server-1", "host": "127.0.0.1", "wsPort": 3014}
    ]
    }
    }`

    const filename = "config.json"
    if err := simulateConfigFile(filename, jsonString); err != nil {
        log.Fatalf("创建模拟文件失败: %v", err)
    }
    defer os.Remove(filename) // 确保程序结束时删除模拟文件

    // 读取文件内容
    content, err := ioutil.ReadFile(filename)
    if err != nil {
        log.Fatalf("读取配置文件失败: %v", err)
    }

    // 定义目标map
    var serverConfigs map[string]map[string][]Service

    // 使用json.Unmarshal解析JSON，注意传递 &serverConfigs
    err = json.Unmarshal(content, &serverConfigs)
    if err != nil {
        log.Fatalf("JSON解析失败: %v", err)
    }

    fmt.Println("成功解析的配置数据:")
    // 遍历并打印部分解析结果以验证
    for env, servicesByType := range serverConfigs {
        fmt.Printf("环境: %s\n", env)
        for serviceType, services := range servicesByType {
            fmt.Printf("  服务类型: %s\n", serviceType)
            for _, s := range services {
                fmt.Printf("    - ID: %s, Host: %s, Port: %d, WsPort: %d\n", s.Id, s.Host, s.Port, s.WsPort)
            }
        }
    }

    // 示例：访问特定配置
    if devConnectors, ok := serverConfigs["development"]["connector"]; ok && len(devConnectors) > 0 {
        fmt.Printf("\n开发环境第一个连接器服务器ID: %s\n", devConnectors[0].Id)
    }
}

运行输出示例：

成功解析的配置数据:
环境: development
  服务类型: connector
    - ID: connector-server-1, Host: 127.0.0.1, Port: 4050, WsPort: 3050
    - ID: connector-server-2, Host: 127.0.0.1, Port: 4051, WsPort: 3051
    - ID: connector-server-3, Host: 127.0.0.1, Port: 4052, WsPort: 3052
  服务类型: chat
    - ID: chat-server-1, Host: 127.0.0.1, Port: 6050, WsPort: 0
    - ID: chat-server-2, Host: 127.0.0.1, Port: 6051, WsPort: 0
    - ID: chat-server-3, Host: 127.0.0.1, Port: 6052, WsPort: 0
  服务类型: gate
    - ID: gate-server-1, Host: 127.0.0.1, Port: 0, WsPort: 3014
环境: production
  服务类型: connector
    - ID: connector-server-1, Host: 127.0.0.1, Port: 4050, WsPort: 3050
    - ID: connector-server-2, Host: 127.0.0.1, Port: 4051, WsPort: 3051
    - ID: connector-server-3, Host: 127.0.0.1, Port: 4052, WsPort: 3052
  服务类型: chat
    - ID: chat-server-1, Host: 127.0.0.1, Port: 6050, WsPort: 0
    - ID: chat-server-2, Host: 127.0.0.1, Port: 6051, WsPort: 0
    - ID: chat-server-3, Host: 127.0.0.1, Port: 6052, WsPort: 0
  服务类型: gate
    - ID: gate-server-1, Host: 127.0.0.1, Port: 0, WsPort: 3014

开发环境第一个连接器服务器ID: connector-server-1

从输出中可以看到，JSON数据被成功解析并映射到了Go的嵌套map和结构体中。未在JSON中提供的字段（如 chat 和 gate 服务中的 WsPort 或 Port）被正确地填充为零值。

注意事项与最佳实践

  1. 错误处理：在实际应用中，始终要对 json.Unmarshal 和文件读取等操作的错误进行严谨处理。
  2. json 标签：
    • json:"fieldName"：用于指定JSON字段名。
    • json:"fieldName,omitempty"：如果字段是其类型的零值（例如，string为空字符串，int为0，bool为false，slice或map为nil），则在编码（Marshal）时会忽略该字段。在解码（Unmarshal）时，它仍然会尝试匹配字段。
    • json:"-"：表示该字段在JSON编码和解码时都将被忽略。
  3. 处理缺失字段：如果JSON中某个字段可能存在也可能不存在，并且你希望区分“存在但为零值”和“完全不存在”的情况，可以考虑将结构体字段定义为指针类型，例如 Port *uint。这样，如果JSON中没有该字段，*Port 将为 nil；如果存在但为零值，*Port 将指向一个值为0的 uint。
  4. 动态或不确定结构：对于结构非常不确定或高度动态的JSON，可以考虑解析到 map[string]interface{} 或 []interface{} 中，然后通过类型断言进行后续处理。
  5. 文件读取：在Go 1.16及更高版本中，io/ioutil 包已被弃用，推荐使用 os.ReadFile 和 os.WriteFile。
  6. 性能考虑：对于非常大的JSON文件，可以考虑使用 json.Decoder 进行流式解析，以减少内存占用。

遵循这些原则，可以有效地在Go语言中处理各种复杂的JSON数据解析任务。核心在于理解Go的类型系统与encoding/json包的交互方式，尤其是指针在数据修改中的作用。

相关文章

如何在Golang中处理路由参数_Golang Web路由动态参数解析技巧

如何使用Golang开发简单爬虫_Golang net/http与HTML解析方法

如何在 Go Web 应用中正确托管 CSS 等静态资源以避免 404 错误

Golang Web项目如何处理静态资源_静态资源管理方案

Go 中的上下文感知变量：安全渲染 HTML 的核心机制

相关标签:

js json go go语言 编码 ai 配置文件 开发环境 内存占用 字符串解析 键值对 gate igs json String 运算符 Error 字符串 结构体 bool int 指针 数据结构 值类型 引用类型 指针类型 Interface Go语言 pointer nil map 对象

本站声明：本文内容由网友自发贡献，版权归原作者所有，本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容，请联系admin@php.cn

上一篇：深入理解Go语言HTML模板中的ZgotmplZ问题及安全实践 下一篇：Golang flag命令行参数解析实践

作者最新文章

Go 中函数返回参数命名规则详解：必须全部命名或全部不命名

2026-01-30 16:48

鱼乐世界怎么注销账户

2026-01-30 16:51

如何在多语言项目中优雅管理 Go 项目结构

2026-01-30 16:51

如何解决 PyAutoGUI 模块无法导入的问题

2026-01-30 16:54

三国天下归心三姐妹追击队玩法攻略

2026-01-30 16:54

ES6 Proxy 实现自迭代数组的完整教程

2026-01-30 16:56

REDMI Turbo 5 Max发布即爆款 2小时刷新2K-3K价位段新机首销记录

2026-01-30 16:57

如何正确按自然数值顺序对带前导零的字符串键对象排序并保持遍历顺序

2026-01-30 16:57

如何正确对带前导零的数字字符串键对象进行自然排序并保持顺序

2026-01-30 16:59

暴力魔改！大神把ROG Matrix 5090 BIOS刷进Astral：解锁额外200W功耗

2026-01-30 17:02

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

AI 编程开发AI 聊天问答
豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

AI 编程开发AI大模型
通义千问
通义千问

阿里巴巴推出的全能AI助手

AI 编程开发Agent智能体
腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文档处理AI 聊天问答
文心一言
文心一言

文心一言是百度开发的AI聊天机器人，通过对话可以生成各种形式的内容。

AI 编程开发AI 文本写作
讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具，可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

AI 文本写作中文写作
即梦AI
即梦AI

一站式AI创作平台，免费AI图片和视频生成。

图片拼接
ChatGPT
ChatGPT

最最强大的AI聊天机器人程序，ChatGPT不单是聊天机器人，还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

AI 编程开发AI 文本写作
智谱清言 - 免费全能的AI助手
智谱清言 - 免费全能的AI助手

智谱清言 - 免费全能的AI助手

AI 编程开发Agent智能体

相关专题

更多
json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章，帮助大家解决问题。

420

2023.08.07

json是什么
json是什么

JSON是一种轻量级的数据交换格式，具有简洁、易读、跨平台和语言的特点，JSON数据是通过键值对的方式进行组织，其中键是字符串，值可以是字符串、数值、布尔值、数组、对象或者null，在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容，供大家免费下载体验。

536

2023.08.23

jquery怎么操作json
jquery怎么操作json

操作的方法有：1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”；3、“$.each(obj, callback)”；4、“$.ajax()”。更多jquery怎么操作json的详细内容，可以访问本专题下面的文章。

311

2023.10.13

go语言处理json数据方法
go语言处理json数据方法

本专题整合了go语言中处理json数据方法，阅读专题下面的文章了解更多详细内容。

77

2025.09.10

string转int
string转int

在编程中，我们经常会遇到需要将字符串(str)转换为整数(int)的情况。这可能是因为我们需要对字符串进行数值计算，或者需要将用户输入的字符串转换为整数进行处理。php中文网给大家带来了相关的教程以及文章，欢迎大家前来学习阅读。

463

2023.08.02

java基础知识汇总
java基础知识汇总

java基础知识有Java的历史和特点、Java的开发环境、Java的基本数据类型、变量和常量、运算符和表达式、控制语句、数组和字符串等等知识点。想要知道更多关于java基础知识的朋友，请阅读本专题下面的的有关文章，欢迎大家来php中文网学习。

1502

2023.10.24

Go语言中的运算符有哪些
Go语言中的运算符有哪些

Go语言中的运算符有：1、加法运算符；2、减法运算符；3、乘法运算符；4、除法运算符；5、取余运算符；6、比较运算符；7、位运算符；8、按位与运算符；9、按位或运算符；10、按位异或运算符等等。本专题为大家提供相关的文章、下载、课程内容，供大家免费下载体验。

232

2024.02.23

php三元运算符用法
php三元运算符用法

本专题整合了php三元运算符相关教程，阅读专题下面的文章了解更多详细内容。

87

2025.10.17

C++ 设计模式与软件架构
C++ 设计模式与软件架构

本专题深入讲解 C++ 中的常见设计模式与架构优化，包括单例模式、工厂模式、观察者模式、策略模式、命令模式等，结合实际案例展示如何在 C++ 项目中应用这些模式提升代码可维护性与扩展性。通过案例分析，帮助开发者掌握 如何运用设计模式构建高质量的软件架构，提升系统的灵活性与可扩展性。

14

2026.01.30

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

相关下载

更多
php商城系统
淘源码商城PHP淘宝查信誉
PHP房产程序[BBWPS]
PHP简约自动发卡平台个人版
ERMEB域名PHP离线网络授权系统
Difeye-敏捷的轻量级PHP框架
大泉州汽车网PHP整站程序

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
前端项目-尚优选【HTML/CSS/JS技术综合实战】
前端项目-尚优选【HTML/CSS/JS技术综合实战】

共39课时 | 4万人学习

WEB前端教程【HTML5+CSS3+JS】
WEB前端教程【HTML5+CSS3+JS】

共101课时 | 8.6万人学习

JS进阶与BootStrap学习
JS进阶与BootStrap学习

共39课时 | 3.2万人学习

最新文章

更多
如何在 Linux 上使用 Go 实时捕获系统音频流并进行 FFT 可视化
使用 Go 语言集成 Azure AD 实现单点登录（SSO）完整指南
如何在 Go 结构体中正确存储 Unicode 字符串
在 Go 语言中集成 Azure AD 实现单点登录（SSO）的完整实践指南
Go 中接口类型内嵌 nil 值的判断原理与正确处理方式
Go 中文件名以 _test.go 结尾导致构建失败的解决方法
如何安全删除 Go 切片中的元素：避免 append 引发的意外内存覆盖
如何在 Google App Engine Go 应用中自定义用户登出逻辑
Go 中构建安全、可扩展的用户认证系统完整指南
如何在 Go 中定义包含整数和字符串切片的嵌套结构？
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网：公益在线php培训，帮助PHP学习者快速成长！
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号

  • PHP学习

  • 技术支持

  • 返回顶部