gRPC反射服务没启用，grpcurl 直接报错 "failed to resolve method: not found"
根本原因不是工具问题，而是服务端压根没注册反射服务。Go 的 grpc.Server 默认不开启反射，必须手动加一行注册逻辑。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 在启动 gRPC 服务的 main 函数里，调用
reflection.Register(server)，且必须在server.Serve()之前 - 确保导入了
"google.golang.org/grpc/reflection"包，这个包不在标准库中，需要go get - 如果用了 gRPC-Gateway 或其他中间件，反射注册必须放在所有拦截器之后、
Serve()之前，否则可能被拦截掉
用 grpcurl 查接口时返回空列表或报 "Failed to list services: server does not support reflection"
说明客户端连上了，但服务端反射协议没生效，常见于 TLS 或 HTTP/2 配置干扰。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 确认服务监听的是纯 HTTP/2（非 h2c），
grpcurl默认走 TLS；若服务是明文，必须加-plaintext参数：grpcurl -plaintext localhost:8080 list - 检查是否启用了
grpc.Creds，但客户端没配对应证书——此时反射请求会被拒绝，错误不明显，表现为“空响应” - 避免在同一个端口混用 gRPC 和 HTTP/1.1 服务（比如 gin + gRPC 复用 listener），反射元数据只对 gRPC 流量有效，HTTP 路由会吞掉反射请求
动态调试时发现 proto 文件版本和运行时不一致，grpcurl 解析出错或字段缺失
反射服务只暴露运行时注册的 service 描述，不读取本地 .proto 文件。如果服务重启后没更新 proto，或用了不同版本的 protoc-gen-go 编译，描述信息就和你本地理解的不匹配。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 调试前先用
grpcurl -plaintext localhost:8080 list和grpcurl -plaintext localhost:8080 describe xxx.Service确认服务端实际暴露了哪些方法和字段 - 不要依赖本地
.proto文件结构去写请求体，用grpcurl -plaintext localhost:8080 describe xxx.Service/Method看真实字段名和类型 - 如果字段名显示为
field1、field2，说明编译时用了旧版protoc-gen-go（v1.26 以前）且没加go_package选项，需升级插件并重生成
在 CI 或容器环境里 grpcurl 连不上，但本地能通
通常是网络策略或 gRPC 反射服务绑定地址不对，而不是权限或证书问题。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 服务启动时监听地址别写
localhost:8080，改用:8080或0.0.0.0:8080，否则容器内其他进程无法访问 - 检查容器是否暴露了正确端口（
docker run -p 8080:8080），且防火墙/Security Group 允许该端口入站 -
grpcurl在 Alpine 容器里可能因缺少 CA 证书失败，可加-insecure（仅测试环境）或挂载系统证书路径
反射服务本身不校验业务逻辑，它只是把内存里的 service descriptor 暴露出去。只要注册时机对、网络通、协议匹配，就能看到真实接口——但这也意味着，它不会告诉你字段语义、默认值或校验规则，那些还得翻代码或文档。
