需手动调用 reflection.register(s) 注册反射服务，且必须在 grpc.server.serve() 前执行；import "google.golang.org/grpc/reflection" 不可省略，生产环境建议关闭。
gRPC Server Reflection 在 Go 里怎么开
Go 默认不开启 gRPC 反射（grpc.reflection.v1.ServerReflection），所以 grpcurl 直接连上去会报 Failed to resolve method list: server does not support reflection API。必须手动注册反射服务，且得在 grpc.Server 启动前完成。
- 用
grpc.ReflectionServer注册，不是加个 flag 或配置项就能开 - 必须在
server.Serve()之前调用reflection.Register(s)，否则无效 - 不需要额外 import proto 或生成代码，反射服务是纯运行时行为
- 生产环境建议关闭（通过构建 tag 或启动参数控制），它会暴露所有 service/method 名称和类型信息
注册反射服务的最小完整写法
很多人只贴了 reflection.Register() 却漏掉 import 或调用时机，导致没生效。下面是能直接跑通的最小片段：
package main
import (
"google.golang.org/grpc"
"google.golang.org/grpc/reflection"
)
func main() {
s := grpc.NewServer()
// 必须在这之后、Serve之前注册
reflection.Register(s)
// 然后才注册你的 service，比如：
// pb.RegisterYourServiceServer(s, &yourServer{})
s.Serve(lis) // lis 是 listener
}
-
import "google.golang.org/grpc/reflection"缺一不可，别用旧路径如github.com/grpc-ecosystem/go-grpc-middleware/reflection -
reflection.Register(s)参数是*grpc.Server，不是 listener 或 handler - 如果用了
grpc.Creds()或其他拦截器，不影响反射注册，但要确保监听端口没被防火墙或代理拦住
grpcurl 调不通的常见原因
grpcurl -plaintext localhost:8080 list 报错，不一定是反射没开，也可能是网络或协议层问题。
Go语言（Golang）1.26.0
下载
Go语言（Golang）1.26.0版本提供 Go 官方 Windows amd64 MSI 安装包下载入口，版本号 1.26.0，可用于旧项目维护、兼容性测试和指定版本开发环境配置。
- 用
-plaintext但 server 实际启用了 TLS：改用-insecure或配好证书 - server 绑定的是
127.0.0.1:8080，而grpcurl尝试连localhost:8080—— 大多数情况没问题，但某些 hosts 配置或 IPv6 优先环境下会失败，可统一用127.0.0.1 - gRPC 服务本身没 listen 成功，先确认
net.Listen("tcp", ":8080")返回 err 为 nil -
grpcurl版本太老（go install github.com/fullstorydev/grpcurl/cmd/grpcurl@latest
反射开启后能看到什么、看不到什么
开了反射，grpcurl list 和 grpcurl describe Xxx 能查到接口定义，但仅限于 protobuf 的结构信息，不包含业务逻辑注释、HTTP 映射、验证规则或自定义 metadata 说明。
- 能看到：service 名、method 名、request/response message 字段名和类型（包括嵌套）、是否是 streaming
- 看不到：proto 文件里的
// comment、validate.rules、google.api.http扩展、enum 的中文枚举值说明 - 字段默认值（如
optional int32 timeout = 1 [json_name = "timeout_ms", default = 3000];）中的default不会被反射返回，grpcurl也无法感知 - 如果 proto 里用了
import public或跨文件引用，反射仍能工作，但grpcurl describe可能只显示字段名，不展开 imported message 定义（取决于 client 端是否加载了对应 proto）
反射只是让 gRPC 协议层“可探索”，它不替代文档，也不解决 proto 和 runtime 类型不一致的问题。上线前最好用 grpcurl 实测几个典型请求路径，避免上线后才发现字段名拼错或 required 字段漏传。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
