go-zero中RPC服务需在config.yaml显式配置Etcd.Hosts和Service.Name并匹配客户端BuildTarget；超时需同步调整服务端RpcServerOptions.Timeout和客户端context.WithTimeout；model空指针应通过errors.Is(err, sqlx.ErrNotFound)判断而非判nil；API与RPC校验统一用types包共享结构体，复用validate tag。
go-zero 里 rpc 服务怎么注册到 etcd？
不配好服务发现，rpc 调用会直接报 rpc error: code = Unavailable desc = connection error——不是代码写错了，是根本连不上目标服务。
关键在 etc/config.yaml（或 config.yml）里必须显式声明 etcd 配置，且 service 的 Name 和 Etcd.Hosts 必须对得上：
-
Etcd.Hosts是 etcd 集群地址，比如["127.0.0.1:2379"]，不能写成http://开头 -
Service.Name要和客户端zrpc.MustNewClient里传的BuildTarget一致，例如"etcd://127.0.0.1:2379/user.rpc"中的user.rpc - 启动时加
-f etc/user.yaml显式指定配置，别依赖默认路径；否则etcd配置不会加载
为什么 zrpc 客户端调用总超时？
默认超时是 1 秒，但实际网络+业务处理常超过这个值，尤其本地调试时 etcd 响应慢、或服务刚启还没 ready，就会触发 context deadline exceeded。
改法很简单，但容易漏掉两处：
- 服务端
Server启动时，用zrpc.RpcServerOptions{Timeout: 5 * time.Second}扩大接收侧超时 - 客户端调用前，必须自己控制
context.WithTimeout，比如ctx, _ := context.WithTimeout(context.Background(), 3*time.Second)，再传给client.SomeMethod(ctx, req) - 别只改
client侧——如果服务端处理逻辑卡在数据库或外部 HTTP，1 秒照样熔断，两边超时要匹配着调
go-zero 的 model 怎么避免空指针 panic？
生成的 model 方法（如 FindOne）返回 *UserModel，但数据库查不到时返回 nil，直接取字段就 panic。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
最稳妥的做法不是加一堆 if u != nil，而是用 go-zero 自带的 sqlx.ErrNotFound 判断：
u, err := m.FindOne(ctx, id)
if err != nil {
if errors.Is(err, sqlx.ErrNotFound) {
return nil, ErrUserNotFound
}
return nil, err
}
// 此时 u 必然非 nil，可放心用 u.Id、u.Name 等
- 所有
FindOne/Find类方法都遵循这个错误约定，不用自己判nil - 注意：自定义 SQL 查询（
QueryRow等）不自动包装ErrNotFound，得手动检查sql.ErrNoRows
如何让 goctl 生成的 API + RPC 不重复写 validate？
API 层校验（validate tag）和 RPC 层校验（rules）分开写，改一处漏一处，后期维护成本高。
统一校验逻辑的关键是：把结构体定义抽到 types 包，让 API 请求体和 RPC 请求体共用同一 struct：
- 在
types/user.go里定义type CreateUserReq struct { Name string `json:"name" form:"name" validate:"required,min=2"` } - API 的 handler 接收这个 struct，RPC 的
service也用它做入参 - 这样
validatetag 只写一次，go-zero的 validator 会自动在 API 层生效；RPC 层需手动调validator.Validate(req)，但逻辑复用，不会脱节
跨层复用结构体这事，看着简单，但很多人图快在 API 和 RPC 各建一套 struct，后面字段一变就得同步改两处，错一个就埋个坑。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
