Kratos中启用gRPC服务端需显式注册并启动：确保internal/server/grpc.go中创建*grpc.Server时传入有效地址（如grpc.Address(":9000")），并在main.go中通过kratos.New(kratos.Server(...))传入该实例；否则服务不监听端口。
怎么在Kratos里启用gRPC服务端
默认生成的Kratos项目已包含gRPC服务端骨架，但必须显式注册并启动，否则grpc.NewServer只是个空结构体，不会监听端口。
- 确认
internal/server/grpc.go中创建*grpc.Server时传入了grpc.Address(":9000")等有效配置 - 检查
main.go中是否将该gRPC服务实例传给了kratos.New(kratos.Server(...))，漏掉会导致服务不启动 - 若需gRPC反射（用于
grpcurl调试），必须手动添加grpc.ReflectionProvider(reflection.GRPCServerReflector(srv))，Kratos v2.7+ 不再默认开启 - 服务端中间件（如
tracing、recovery）需通过grpc.Middleware选项注入，不是直接挂到kratos.Server上
客户端怎么连上gRPC服务
本地直连和生产环境服务发现是两套完全不同的初始化逻辑，混用必然失败。
- 开发调试阶段，用
grpc.Dial("127.0.0.1:9000", grpc.WithTransportCredentials(insecure.NewCredentials()))，insecure.NewCredentials()不能省，否则卡在context deadline exceeded - 生产环境应使用服务发现地址，如
discovery:///helloworld.service，此时需确保internal/client/grpc.go中已配置对应registry实例，并调用grpc.WithResolvers - 务必核对
ClientConn是否被正确注入到service或repository层，常见错误是只创建了连接却没传给业务代码 - 如果用
kratos proto client生成的客户端，它默认依赖transport/grpc包里的NewClient，该函数会自动处理拦截器和重试，别自己重复封装
Protobuf定义和服务代码怎么对齐
Protobuf不是装饰，它是Kratos gRPC通信的契约源头，任何改动都必须触发重新生成，否则运行时panic或字段丢失。
-
api/xxx/v1/xxx.proto里必须import "google/api/annotations.proto"，即使不用HTTP映射，某些插件（如protoc-gen-go-http）也依赖此导入 - 生成服务端代码用
kratos proto server api/xxx/v1/xxx.proto -t internal/service，生成客户端用kratos proto client api/xxx/v1/xxx.proto，路径参数错一位就找不到文件 - 注意
option go_package的值要和Go模块路径一致，比如github.com/your-org/project/api/xxx/v1;xxxv1，否则go build报import cycle或类型未定义 - 如果proto里用了
google.api.http，且同时启用了protoc-gen-go-http，那HTTP handler会自动生成到internal/server/http.go，但gRPC服务仍走独立的grpc.Server，两者互不影响
为什么gRPC调用总返回“connection refused”或“stream error”
这类错误基本不出现在业务逻辑里，而是卡在传输层握手或HTTP/2帧解析阶段，得从连接生命周期倒推。
- 先用
telnet 127.0.0.1 9000确认端口是否真在监听；若不通，检查grpc.Address绑定的是0.0.0.0:9000还是127.0.0.1:9000，Docker容器内访问宿主需用host.docker.internal - 用
grpcurl -plaintext localhost:9000 list验证基础连通性，失败则优先查反射配置，不是改client代码 - Wireshark抓包看是否发出
SETTINGS帧——没发说明TLS/credentials配置错误；发了但没回HEADERS，大概率服务端panic崩溃或gRPC Server未RegisterService - 日志里出现
transport: Got too many pings from client，说明客户端心跳太密或服务端没及时响应，调大KeepaliveParams中的Time和Timeout
真正容易被忽略的是：gRPC服务端注册必须在app.Run()之前完成，而Kratos的server.Register调用藏在server.New内部，如果你手动改过internal/server/grpc.go逻辑，可能无意中破坏了这个顺序。
