go-zero 参数校验：写在 handler 还是 logic？

格式 / 字段校验在 handler，业务校验在 logic

go-zero 把「请求绑定 + 字段格式校验」固化在了生成的 handler.go 里，通过 httpx.Parse(r, &req) 完成；规则声明在 types 结构体的 tag 上。而「这个用户存不存在、密码对不对、状态能不能操作」这种业务校验，只能写在你手写的 logic 里。

goctl 生成的 handler，校验就长在里面

这是 goctl api go 实际吐出来的 loginhandler.go。注意看：httpx.Parse 是 goctl 帮你写好的，不是你手写的。它一执行，path / query / form / header / body 就绑定好了，字段格式也校验完了。

package handler

import (
    "net/http"

    "hello/internal/logic"
    "hello/internal/svc"
    "hello/internal/types"

    "github.com/zeromicro/go-zero/rest/httpx"
)

func LoginHandler(svcCtx *svc.ServiceContext) http.HandlerFunc {
    return func(w http.ResponseWriter, r *http.Request) {
        var req types.LoginRequest
        // ↓↓↓ 字段格式校验就在这里发生（goctl 生成）↓↓↓
        if err := httpx.Parse(r, &req); err != nil {
            httpx.ErrorCtx(r.Context(), w, err) // 自动 400 + 错误信息
            return
        }
        // 校验通过后才进 logic，req 已经是「干净」的结构体
        l := logic.NewLoginLogic(r.Context(), svcCtx)
        resp, err := l.Login(&req)
        if err != nil {
            httpx.ErrorCtx(r.Context(), w, err)
        } else {
            httpx.OkJsonCtx(r.Context(), w, resp)
        }
    }
}

校验规则写在 types 结构体的 tag 上

go-zero 原生支持一组「开箱即用、零配置」的校验标签（由 core/mapping 在 httpx.Parse 时执行）。默认所有字段都是必填，加 optional 才变可选。

type LoginRequest struct {
    // 绑定来源 + 校验，全部用 tag 声明，不用手写 if
    Username string `json:"username"`                  // 必填（默认），来自 body
    Password string `json:"password,optional"`         // 可选
    Page     int64  `form:"page,default=1"`             // query，默认 1
    Size     int64  `form:"size,default=20,range=[1:100]"` // 范围 1~100
    Role     string `form:"role,options=admin|user"`    // 枚举值
    Token    string `header:"X-Token"`                  // 来自请求头
    UserID   int64  `path:"id"`                        // 来自路径 /api/users/:id
}

httpx.Parse 内部到底做了什么

Parse(r, &req) 按固定顺序把四个来源依次绑进结构体，最后跑校验。这就是「参数校验在 handler」的底层依据——整条链路都在 handler 调用 Parse 的那一行里完成。

两种校验机制，都在 handler 触发

go-zero 有「原生 tag 校验」和「自定义校验」两套。但不管哪套，触发点都在 httpx.Parse（即 handler 里）——你永远不要把它挪到 logic。

// 方式 A：在 types 结构体上实现 Validate() error，Parse 后自动调用
func (req RegisterRequest) Validate() error {
    if len(req.Password) < 8 {
        return errors.New("密码至少 8 位")
    }
    return nil
}

// 方式 B：注册全局校验器后，结构体可用 validate 标签
// 在 svc 初始化或 main 里：httpx.SetValidator(myValidator)
type RegisterRequest struct {
    Email string `json:"email" validate:"required,email"`
}

业务校验只能写在 logic

「用户存不存在」「密码对不对」「账号是否被禁」这类规则，handler 阶段还没法判断——因为要查库 / 调 RPC / 读缓存。所以它们天然落在 logic。注意 logic 拿到的 req 已经是「格式校验通过」的了。

func (l *LoginLogic) Login(req *types.LoginRequest) (*types.LoginResponse, error) {
    // req 已经过 httpx.Parse 校验：username 必填、role 在枚举内……
    // 下面才是「业务校验」，只能在这做：
    u, err := l.svcCtx.UserModel.FindOneByUsername(l.ctx, req.Username)
    if err == model.ErrNotFound {
        return nil, errorx.New(code.UserNotFound) // 业务错误码
    }
    if !checkPassword(req.Password, u.Password) {
        return nil, errorx.New(code.PasswordWrong)
    }
    if u.Status == Banned {
        return nil, errorx.New(code.AccountBanned)
    }
    // ... 真正业务逻辑
}

handler 与 logic 各放什么

四个最容易踩的坑

顺着这条线继续看