Go语言读取JSON配置时反序列化失败的问题修复及字段读取方法

我来帮你一步步排查和解决这个JSON反序列化的问题，咱们先理清楚问题出在哪，再给出可行的修复方案：

一、核心问题分析 #

1. 配置文件格式/语法错误
   你提供的第一个JSON配置里，UseCases数组的元素是一个被转义包裹的JSON字符串，而且从你描述的getList返回值来看，这个字符串还存在语法错误（比如"Name":"CV"和"FieldMappings"之间缺少逗号，"FieldMappings"结尾和"Reference"之间也缺少逗号），这直接触发了unexpected end of JSON input的错误——JSON语法不合法，Unmarshal根本无法解析。

   另外你提到的第二个配置文件是标准的JSON对象数组格式，但代码里用的配置路径是PaymentPlatform.UseCases，如果第一个配置的顶层键是Platform而非PaymentPlatform，会导致获取不到正确的列表数据。

2. 代码逻辑的适配问题
   如果配置文件能改成标准JSON结构，那代码可以大幅简化；如果必须使用转义后的字符串格式，就需要先修复字符串的语法错误，再进行反序列化。

二、修复方案（分两种场景） #

场景1：可以修改配置文件为标准JSON格式（推荐） #

这是最省心的方案，把UseCases改成直接存储JSON对象数组，不需要转义成字符串：

{
  "PaymentPlatform": {
    "UseCases": [
      {
        "Name": "CV",
        "FieldMappings": {
          "Account": "AccountId",
          "Status": "Stat",
          "Until": "Valid"
        },
        "Reference": "DB"
      }
    ]
  }
}

对应的代码可以简化为：

type UseCaseConfig struct {
    Name          string            `json:"Name"`
    FieldMappings map[string]string `json:"FieldMappings"`
    Reference     string            `json:"Reference"`
}

func LoadUseCases(cfg configservice.AppConfiguration) []UseCaseConfig {
    var useCases []UseCaseConfig
    // 注意路径要和配置文件的顶层键严格匹配
    rawList := cfg.GetList("PaymentPlatform.UseCases")

    for _, raw := range rawList {
        // 若GetList返回的是interface{}类型，先序列化为字节再反序列化
        rawBytes, err := json.Marshal(raw)
        if err != nil {
            log.Printf("Failed to marshal raw use case: %v", err)
            continue
        }
        var uc UseCaseConfig
        if err := json.Unmarshal(rawBytes, &uc); err != nil {
            log.Printf("Failed to unmarshal use case: %v\nRaw: %v", err, raw)
            continue
        }
        useCases = append(useCases, uc)
    }
    return useCases
}

场景2：无法修改配置文件，必须处理转义的JSON字符串 #

如果只能使用转义后的字符串格式，首先要修复字符串中的语法错误，再进行反序列化：

import "strings"

func LoadUseCases(cfg configservice.AppConfiguration) []UseCaseConfig {
    var useCases []UseCaseConfig
    // 路径和配置文件顶层键匹配：如果配置是Platform就用Platform.UseCases
    rawList := cfg.GetList("Platform.UseCases")

    for _, rawStr := range rawList {
        // 修复JSON语法错误：补全键值对之间缺失的逗号
        fixedStr := strings.ReplaceAll(rawStr, `" "`, `", "`)
        fixedStr = strings.ReplaceAll(fixedStr, `} "`, `}, "`)

        var uc UseCaseConfig
        if err := json.Unmarshal([]byte(fixedStr), &uc); err != nil {
            log.Printf("Failed to unmarshal use case JSON: %v\nRaw: %s\nFixed: %s", err, rawStr, fixedStr)
            continue // 跳过错误用例，继续处理其他可用项
        }
        useCases = append(useCases, uc)
    }
    return useCases
}

三、正确读取字段的方式 #

当成功反序列化得到UseCaseConfig实例后，直接通过结构体字段访问即可：

useCases := LoadUseCases(yourConfig)
for _, uc := range useCases {
    // 读取Name字段
    fmt.Println("Use Case Name:", uc.Name)
    // 读取Reference字段
    fmt.Println("Reference:", uc.Reference)
    // 读取FieldMappings中的具体映射
    fmt.Println("Account Mapping:", uc.FieldMappings["Account"])
    // 遍历所有字段映射
    for field, mappedField := range uc.FieldMappings {
        fmt.Printf("Original Field: %s → Mapped Field: %s\n", field, mappedField)
    }
}

四、额外注意事项 #

1. 配置路径严格匹配：如果配置文件顶层键是Platform，代码里就用Platform.UseCases；如果是PaymentPlatform就对应调整，路径不匹配会导致获取不到数据。
2. 优先使用标准JSON格式：尽量避免在配置中存储转义的JSON字符串，这会增加解析复杂度和出错概率。
3. 提升代码健壮性：不要在单个用例解析失败时直接返回nil，可以选择跳过错误项，保留可用的用例数据。

内容来源于stack exchange