必须将proto生成的服务实现注册到gRPC Server，否则请求返回Unimplemented；需在grpc.NewServer后调用pb.RegisterGreeterServer(srv, &service.GreeterService{})，并确保结构体嵌入UnimplementedGreeterServer、实现全部方法且依赖已注入。
要在Kratos项目中让自动生成的gRPC服务代码真正响应请求，必须将proto定义生成的接口实现体注册进gRPC Server实例，否则服务启动后所有调用都会返回Unimplemented，且无任何错误日志提示；这一步遗漏是新人踩坑率最高的环节，因为kratos proto server命令只生成空壳文件，不自动注入。
把生成的服务实现注册到gRPC Server
打开 internal/server/grpc.go 文件。
在 initGRPCServer 函数内部，找到 grpc.NewServer(...) 创建服务实例的位置。
在该行下方插入注册语句：pb.RegisterGreeterServer(srv, &service.GreeterService{}) —— 注意 service 包路径要与你实际生成的服务结构体所在目录一致，比如 api/greeter/greeter.proto 生成的结构体默认在 internal/service/greeter_service.go 中，对应包名是 service。
【必须确保 &service.GreeterService{} 是实现了 pb.GreeterServer 接口的完整实例】，否则运行时 panic：“missing implementation for …”。检查 internal/service/greeter_service.go 开头是否有 var _ pb.GreeterServer = (*GreeterService)(nil) 这行类型断言，没有就手动补上。
填充业务逻辑到生成的服务结构体
进入 internal/service/greeter_service.go。
找到 SayHello 方法的空实现：func (s *GreeterService) SayHello(ctx context.Context, in *pb.HelloRequest) (*pb.HelloReply, error) { return nil, errors.New("unimplemented") }。
删掉 return nil, errors.New("unimplemented")，改写为真实逻辑，例如：return &pb.HelloReply{Message: "Hello " + in.GetName()}, nil。
这一步操作起来很简单，但必须在注册之后做——如果先填逻辑再注册，代码能跑通；但如果只填逻辑没注册，服务根本收不到请求，调试时会误以为是业务代码写错了。
确保服务结构体正确嵌入 UnimplementedGreeterServer
检查 internal/service/greeter_service.go 中 GreeterService 结构体定义：
type GreeterService struct { pb.UnimplementedGreeterServer } —— 这行不能删。
它提供默认未实现方法的兜底行为，避免 gRPC Server 启动时报 panic。如果你确认已实现全部接口方法，可以删掉嵌入，但一旦漏掉一个，服务启动即崩溃，且错误堆栈不指向具体缺失方法，排查极难。
若你使用的是 kratos v2.10+，生成模板已默认包含该嵌入，无需手动添加；低版本需自行补全。
验证客户端调用是否走通
第一步：启动服务，执行 kratos run。
第二步：用 protoc-gen-go-grpc 生成的 client 代码，或 Apipost / BloomRPC 等工具，向 localhost:9000 发起 gRPC 调用。
第三步：观察服务端日志是否输出 SayHello 处理成功信息；若返回 status code: Unknown，大概率是未注册服务；若返回 status code: Unimplemented，则是注册了但方法体仍为 return nil, errors.New("unimplemented")。
第四步：确认 internal/service/greeter_service.go 中的 GreeterService 实例被传入 RegisterGreeterServer 时未被 nil 指针解引用——【不要传 &GreeterService{} 的零值指针，必须确保其依赖的 biz 或 data 层已通过 DI 注入完成】。
