Kratos中gRPC连接超时必须在grpc.Dial阶段解决：需显式配置WithTimeout控制建连总耗时、WithBlock阻塞等待建连结果，否则连接未建立即发起调用将导致context deadline exceeded错误，而非业务超时。
Kratos 里 gRPC 连接超时不是靠重试解决的，而是必须在 grpc.Dial 阶段就堵死——不加 WithTimeout 和 WithBlock，后续所有重试都只是把问题往后拖，甚至放大成雪崩。
grpc.Dial 必须显式配 WithTimeout 和 WithBlock
默认 grpc.Dial 是异步建连：返回 *grpc.ClientConn 时 TCP 握手可能根本没开始。服务端宕机或地址写错，conn 会一直卡在 Ready() == false，第一次 RPC 才暴露为 context deadline exceeded——这不是请求超时，是连接压根没建好。
-
grpc.WithTimeout(5 * time.Second)控制整个建连过程（DNS、TCP、TLS）的总耗时 -
grpc.WithBlock()让Dial阻塞直到成功或超时，避免把失败藏到业务调用时才爆 - 别用
context.WithTimeout包第一次 RPC——它只等响应，不等连接建立 - Kratos 项目中通常补在
internal/client/grpc.go的grpc.Dial调用处
连接建好了但发第一个请求就断：检查 Keepalive 双端配置
现象是 connection closed before server preface received 或 transport is closing，本质是中间网络设备（防火墙/NAT/SLB）静默回收了空闲连接，而 gRPC 两端没协商心跳保活。
- 服务端必须设
grpc.KeepaliveParams，至少含MaxConnectionIdle: 30 * time.Second - 客户端配
grpc.WithKeepaliveParams，Time建议 ≤ 15s，且PermitWithoutStream: true - 只配客户端不配服务端 → 心跳发出去没人回，照样断；只配服务端不配客户端 → 客户端压根不发心跳
- Kratos 服务端示例中常漏掉
grpc.KeepaliveParams，仅配了MaxConcurrentStreams等参数
重试策略不能盲目套用，得看接口类型和错误码
gRPC 连接建连失败（如 connection refused、timeout）可重试；但连接已建好后，业务层返回的 codes.InvalidArgument 或 codes.AlreadyExists 绝对不能重试——否则就是重复下单、重复扣款。
- 读接口（如
ListServices）可配 2 次重试 + 指数退避，失败码限定为codes.Unavailable、codes.DeadlineExceeded - 写接口（如
CreateOrder）禁用自动重试，必须由业务层基于幂等 key 主动判重 - Kratos
grpc.Client默认不带重试中间件，需手动加retry.Interceptor并严格过滤codes - 别把连接超时错误（
rpc error: code = Unavailable desc = connection closed）和业务错误混在一起重试
调试时先绕过服务发现，直连验证 TCP 层是否通
很多人以为连接超时是代码问题，实际是连错了端口或服务端没开 gRPC 监听。用 telnet 127.0.0.1 9000 或 nc -zv 127.0.0.1 9000 能 1 秒内确认 TCP 是否可达，比跑代码快十倍。
- 确认
internal/server/grpc.go中grpc.NewServer绑定的是 gRPC 端口（如 9000），不是 HTTP 端口（如 8000） - 客户端
grpc.Dial地址写"127.0.0.1:9000"，而非"discovery:///xxx.service"—— 后者失败路径更隐蔽，容易误判 - 明文连接必须带
grpc.WithTransportCredentials(insecure.NewCredentials())，漏掉会导致 TLS 握手卡住，表现和超时一致 - 用
grpcurl -plaintext 127.0.0.1:9000 list测试前，先确认服务端启用了反射：grpc.ReflectionProvider(reflection.GRPCServerReflector(srv))
真正难的不是加几个参数，而是分清「连接没建好」和「连接建好了但业务失败」——前者靠 Dial 配置堵在源头，后者靠错误码分类和幂等设计兜底。大部分线上事故，都出在这两层边界的模糊地带。
