业务函数不能直接封装进grpc服务，必须重写为符合protobuf契约的handler；protobuf定义须先于go代码，字段名决定序列化行为，生成go结构体首字母大写但wire传输用小写下划线；grpc handler需提取独立业务逻辑、注入依赖、映射错误码；客户端须设context超时并用status.code(err)处理标准错误码；proto3无nil值，需用wrapper类型或校验区分零值语义。
直接说结论：业务函数不能“封装”进gRPC服务——必须重写为符合gRPC契约的handler，且Protobuf定义决定接口形状，不是装饰器式套壳。
Protobuf定义必须先于Go代码，且字段命名直接影响序列化行为
很多人想把现有 func (u *User) UpdateName(newName string) error 直接“挂”到gRPC上，这是行不通的。gRPC要求所有入参、返回值都通过Protobuf message定义。比如你要暴露用户改名功能，就得先写：
message UpdateUserNameRequest {
string user_id = 1;
string new_name = 2;
}
message UpdateUserNameResponse {
bool success = 1;
string message = 2;
}
service UserService {
rpc UpdateUserName(UpdateUserNameRequest) returns (UpdateUserNameResponse);
}
注意：user_id 和 new_name 是字段名，不是Go变量名；生成的Go struct里是 UserId 和 NewName（首字母大写），但Wire上传输的是小写下划线形式——这点在调试时容易因命名错位导致空值。
Go服务端实现必须满足接口签名，不能复用原业务函数参数
protoc生成的服务接口形如 func (s *UserServiceServer) UpdateUserName(ctx context.Context, req *pb.UpdateUserNameRequest) (*pb.UpdateUserNameResponse, error)。你不能把 req.NewName 直接传给旧函数，因为旧函数可能依赖DB句柄、日志实例等上下文，而gRPC handler只接收request和ctx。
- 必须提取业务逻辑到独立函数，例如
func updateUserByName(userID string, newName string, db *sql.DB) error - handler里做参数转换、错误映射（如将
sql.ErrNoRows转为status.Errorf(codes.NotFound, ...)） - 不要在handler里初始化DB或配置——这些该在server启动时注入到server struct里
客户端调用前必须处理context超时和错误码，否则会卡死或掩盖真实问题
直接用 client.UpdateUserName(context.Background(), req) 是危险的。生产环境必须设超时：
ctx, cancel := context.WithTimeout(context.Background(), 5*time.Second) defer cancel() resp, err := client.UpdateUserName(ctx, req)
同时，err 不是简单判空就行：status.Code(err) 才是gRPC标准错误码，codes.NotFound、codes.InvalidArgument 都要单独处理；err.Error() 只适合日志，不能用于前端展示。
容易被忽略的点：Protobuf import路径、gRPC拦截器、以及proto3的默认零值陷阱
Protobuf里没声明 optional 的字段（proto3默认全optional），int32 字段即使没传也会被反序列化为0，而不是nil——这意味着你无法区分“用户真的传了0”和“根本没传这个字段”。解决办法只有两个：
- 用指针类型字段（
int32 value = 1;→ 改成int32? value = 1;不行，proto3不支持，得用google.protobuf.Int32Value） - 或加校验逻辑，在handler里检查是否属于“有意传0”的业务场景
另外，import "google/protobuf/wrappers.proto"; 这类路径必须确保protoc能访问到，否则生成失败；拦截器（如鉴权、日志）不能靠修改handler内部逻辑实现，得用 grpc.UnaryInterceptor 注册，否则每次新增方法都要重复写一遍校验。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
