必须严格遵循路径、包名、插件三重约束：proto文件须置于api/子目录，package声明须与目录结构一致（如api/user/v1/user.proto对应package user.v1;），并导入google/api/annotations.proto；执行kratos proto server生成service模板后，需手动在grpc.go中注册服务、删除Unimplemented嵌入、补全业务逻辑实现。
要用 Kratos 框架基于 .proto 文件生成可运行的服务端骨架代码，必须严格遵循路径、包名、插件三重约束，否则生成的 service 结构体无法注册到 gRPC Server，服务启动即 panic。
确认 proto 文件位置与 package 声明是否合规
检查 【proto 文件必须放在 api/ 子目录下】，例如 api/user/v1/user.proto；若放在 internal/api/ 或 proto/ 下，kratos proto server 命令会静默跳过，不报错也不生成任何文件。
打开该 .proto 文件，确认 package 声明与目录结构完全一致：api/user/v1/user.proto 对应 package user.v1;，不能写成 package api.user; 或 package v1;。否则生成的 Go 包路径错乱，import 语句失效，编译失败。
确保已 import "google/api/annotations.proto" —— 缺失此行会导致后续 HTTP 映射注解（如 option (google.api.http) = { get: "/user" };）被忽略，且 kratos proto server 可能因依赖缺失而中断。
执行 kratos proto server 生成 service 模板
在项目根目录下运行命令：kratos proto server api/user/v1/user.proto -t internal/service。
这一步会生成 internal/service/user_service.go，但注意：它只是空壳——所有 RPC 方法体都返回 return nil, errors.New("unimplemented")，且未实现 gRPC Server 注册逻辑。
生成后立即检查文件顶部是否有 var _ pb.UserServiceServer = (*UserService)(nil) 这行类型断言。没有它，编译可能通过，但运行时调用未实现方法会 panic：“missing implementation for …”。
手动完成服务注册与实现补全
第一步：打开 internal/server/grpc.go，在初始化 gRPC Server 的地方添加注册语句：
pb.RegisterUserServiceServer(srv, &service.UserService{...}) —— 注意传入的是你实现的结构体实例，不是接口或 nil。
第二步：进入 internal/service/user_service.go，删掉自动生成的 UnimplementedUserServiceServer 嵌入（除非你确定实现了全部方法），否则未覆盖的方法仍会返回 unimplemented 错误。
第三步：在 UserService 结构体中补全业务逻辑，例如 SayHello 方法需改写为 return &v1.HelloReply{Message: "Hello " + req.GetName()}, nil，否则客户端永远收到 “unimplemented”。
