Go REST API开发中同一struct适配多请求序列化方案咨询

核心思路是将字段改为指针类型区分「未传值」和「零值」，同时把参数校验逻辑和JSON序列化标签解耦，全程只用一个Person struct实现所有场景需求，无需定义多个重复的DTO结构。

步骤1：调整Struct定义 #

引入轻量校验库go-playground/validator做参数校验，字段改用指针类型，保留原有序列化标签：

import (
    "errors"
    "github.com/go-playground/validator/v10"
)

// 全局校验器初始化
var validate *validator.Validate

func init() {
    validate = validator.New()
}

type Person struct {
    Name        *string `json:"name" firestore:"name" validate:"required"`
    Gender      *string `json:"gender,omitempty" firestore:"gender"`
    Nationality *string `json:"nationality,omitempty" firestore:"nationality"`
}

如果你不想引入第三方依赖，也可以完全手写校验逻辑，无需加validate标签。

步骤2：分场景实现校验逻辑 #

GET请求场景 #

从Firebase读取的Person实例所有字段都有有效值，指针非空，序列化时不会触发omitempty规则，所有字段都会正常返回，符合需求。

POST请求场景 #

反序列化后额外校验所有非Name字段不为空即可：

func (p Person) ValidatePOST() error {
    // 先校验Name必填
    if err := validate.Struct(p); err != nil {
        return err
    }
    // 额外校验POST要求的必填字段
    if p.Gender == nil {
        return errors.New("gender is required")
    }
    if p.Nationality == nil {
        return errors.New("nationality is required")
    }
    return nil
}

PATCH请求场景 #

直接调用默认校验逻辑，仅校验Name必填：

func (p Person) ValidatePATCH() error {
    return validate.Struct(p)
}

更简洁的进阶实现 #

用校验库的条件校验规则，不用单独写两个校验方法：

type Person struct {
    Name        *string `json:"name" firestore:"name" validate:"required"`
    Gender      *string `json:"gender,omitempty" firestore:"gender" validate:"required_if=IsPatch false,omitempty"`
    Nationality *string `json:"nationality,omitempty" firestore:"nationality" validate:"required_if=IsPatch false,omitempty"`
    IsPatch     bool    `json:"-"` // 内部标记字段，不参与序列化/存储
}

使用时：

• POST请求：实例化时IsPatch = false，调用validate.Struct(p)会自动校验所有字段必填
• PATCH请求：实例化时IsPatch = true，调用validate.Struct(p)仅校验Name必填

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