使用Viper反序列化含嵌入结构体指针的配置报错及解决

报错* HttpReporterConfig: unsupported type for squash: ptr的核心原因是：Viper底层依赖的mapstructure库不支持对指针类型的嵌入结构体使用squash标签。

方案一：将嵌入的指针改为值类型（推荐） #

直接修改HttpTracingConfig的定义，把嵌入的指针类型替换为值类型，这是最简洁的解决方式：

type HttpTracingConfig struct {
    HttpReporterConfig `mapstructure:",squash" validate:"required"`
    // ... 其他原有字段
}

调整后，mapstructure:"squash"可以正常解析配置文件中的扁平结构，原有的校验逻辑和配置文件内容无需任何改动。HttpReporterConfig的Url指针字段依然会被validator校验是否必填。

方案二：保留指针嵌入的替代方案（仅特殊场景使用） #

如果业务逻辑必须保留*HttpReporterConfig指针（比如允许该配置项为nil），可以通过以下两种方式处理：

方式1：移除squash标签并调整配置结构 #

修改HttpTracingConfig去掉squash标签：

type HttpTracingConfig struct {
    *HttpReporterConfig `validate:"required"`
    // ... 其他原有字段
}

同时调整配置文件的结构，增加一层嵌套：

{
  // ... 其他配置
  "tracing": {
    "HttpReporterConfig": {
      "url": "http://zipkin-svc..."
    },
    // ... 其他tracing字段
  }
}

方式2：自定义反序列化逻辑 #

如果不想修改配置文件结构，可以在反序列化后手动初始化指针并赋值：

1. 修改HttpTracingConfig，临时添加对应配置字段的属性：

type HttpTracingConfig struct {
    *HttpReporterConfig `validate:"required"`
    TempUrl *string `mapstructure:"url"`
    // ... 其他原有字段
}

2. 在加载配置的函数中手动完成指针初始化：

func Load(configPath string) (*Config, error) {
    viper.SetConfigFile(configPath)

    if err := viper.ReadInConfig(); err != nil {
        return nil, err
    }

    var config Config
    if err := viper.Unmarshal(&config); err != nil {
        return nil, err
    }

    // 手动初始化HttpReporterConfig
    if config.TracingConfig != nil && config.TracingConfig.TempUrl != nil {
        config.TracingConfig.HttpReporterConfig = &HttpReporterConfig{
            Url: config.TracingConfig.TempUrl,
        }
        config.TracingConfig.TempUrl = nil // 可选：清空临时字段
    }

    return &config, validator.Struct(&config)
}

内容的提问来源于stack exchange，提问作者Vsevolod Molchanov