Go/Gin/sqlc更新API优化：简化输入到参数的转换

问题核心 #

你当前通过指针类型（*string）区分JSON请求中「未提供字段」和「提供空值」的思路是正确的，但逐个字段判断的方式在字段增多时容易出错且冗余。以下是几种简洁低错的优化方案：

方案1：通用反射工具函数 #

写一个通用函数自动将UpdateAuthorInput中的非nil指针字段赋值到UpdateAuthorParams，避免重复的if判断：

import "reflect"

// copyNonNilFields 将源结构体的非nil指针字段赋值给目标结构体对应字段
func copyNonNilFields(dst, src interface{}) error {
    dstVal := reflect.ValueOf(dst).Elem()
    srcVal := reflect.ValueOf(src).Elem()

    if dstVal.Type() != srcVal.Type() {
        return fmt.Errorf("类型不匹配: %s vs %s", dstVal.Type(), srcVal.Type())
    }

    for i := 0; i < srcVal.NumField(); i++ {
        srcField := srcVal.Field(i)
        if srcField.Kind() != reflect.Ptr || srcField.IsNil() {
            continue
        }

        dstField := dstVal.Field(i)
        // 针对sql.NullString做特殊处理
        if dstField.Type() == reflect.TypeOf(sql.NullString{}) {
            strVal := srcField.Elem().String()
            dstField.Set(reflect.ValueOf(sql.NullString{String: strVal, Valid: true}))
        } else {
            dstField.Set(srcField.Elem())
        }
    }
    return nil
}

// 简化后的data方法
func (a UpdateAuthorInput) data(current data.Author) (data.UpdateAuthorParams, error) {
    params := data.UpdateAuthorParams{
        ID:   current.ID,
        Name: current.Name,
        Bio:  current.Bio,
    }

    if err := copyNonNilFields(&params, &a); err != nil {
        return data.UpdateAuthorParams{}, err
    }
    return params, nil
}

注意：需保证UpdateAuthorInput和UpdateAuthorParams的字段名完全一致，否则需额外处理标签映射。

方案2：自定义兼容JSON与SQL的NullString类型 #

自定义类型直接处理JSON解析和SQL NULL的语义差异，减少转换步骤：

type JSONNullString struct {
    sql.NullString
}

// UnmarshalJSON 区分JSON中的null、空字符串和未提供字段
func (j *JSONNullString) UnmarshalJSON(data []byte) error {
    if string(data) == "null" {
        j.Valid = false
        return nil
    }
    if err := json.Unmarshal(data, &j.String); err != nil {
        return err
    }
    j.Valid = true
    return nil
}

// 修改输入结构体
type UpdateAuthorInput struct {
    Name *string         `json:"name"` // 用指针区分未提供/空值
    Bio  JSONNullString  `json:"bio"`
}

// 简化转换逻辑
func (a UpdateAuthorInput) data(current data.Author) data.UpdateAuthorParams {
    params := data.UpdateAuthorParams{
        ID:   current.ID,
        Name: current.Name,
        Bio:  current.Bio,
    }

    if a.Name != nil {
        params.Name = *a.Name
    }
    if a.Bio.Valid {
        params.Bio = a.Bio.NullString
    }

    return params
}

优势：自定义类型直接衔接JSON和SQL的语义差异，代码逻辑更直观。

方案3：调整sqlc生成逻辑+SQL条件更新 #

修改sqlc配置和SQL语句，让生成的参数结构体支持直接复用输入逻辑：

1. 调整SQL更新语句，用COALESCE自动保留未更新字段的原值：

UPDATE authors
SET name = COALESCE($1, name), bio = COALESCE($2, bio)
WHERE id = $3
RETURNING id, name, bio;

2. 修改sqlc配置，让生成的参数字段为指针类型：

# sqlc.yaml
version: "2"
sql:
  - schema: "schema.sql"
    queries: "queries.sql"
    engine: "postgresql"
    gen:
      go:
        package: "data"
        out: "data"
        sql_package: "database/sql"
        overrides:
          - column: "authors.name"
            go_type: "*string"
          - column: "authors.bio"
            go_type: "*sql.NullString"

3. 简化转换逻辑：

func (a UpdateAuthorInput) data(current data.Author) data.UpdateAuthorParams {
    params := data.UpdateAuthorParams{
        ID:   current.ID,
        Name: &current.Name,
        Bio:  &current.Bio,
    }

    if a.Name != nil {
        params.Name = a.Name
    }
    if a.Bio != nil {
        params.Bio = &sql.NullString{String: *a.Bio, Valid: true}
    }

    return params
}

优势：利用SQL的COALESCE函数自动处理未更新字段，Go代码的转换逻辑大幅简化。

关键语义说明 #

• Go中JSON解析时，指针类型字段为nil会被忽略，普通字符串字段会默认初始化为空字符串，这是你用*string区分「未提供」和「空值」的核心依据。
• SQL的NULL表示「不存在的值」，空字符串是「存在但为空的值」，两者语义不同，你当前通过sql.NullString的Valid字段正确映射了这个差异。

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