Go语言本身无内置拦截器,是否支持取决于所用RPC框架:net/rpc不支持,gRPC原生支持;服务端需注册符合grpc.UnaryServerInterceptor签名的函数,客户端用grpc.UnaryClientInterceptor,多拦截器应使用go-grpc-middleware链式组合。
golang 本身没有内置的“拦截器”抽象,是否能设、怎么设,完全取决于你用的是哪个 RPC 或通信框架。标准库 net/rpc 不支持拦截器;而 gRPC 原生支持,且是当前主流选择。别在 net/rpc 上硬套拦截逻辑——它没上下文、没方法元信息、没统一入口,强行加只会导致维护成本飙升。
gRPC 服务端一元拦截器怎么注册
这是最常用场景:在每个 getuser、createorder 等一元调用前后插入日志、鉴权、耗时统计等逻辑。
- 拦截函数签名必须严格匹配
grpc.UnaryServerInterceptor类型:接收context.Context、请求体interface{}、*grpc.UnaryServerInfo和grpc.UnaryHandler -
info.FullMethod是完整路径(如/user.UserService/GetUser),不是结构体方法名,可用于路由级判断 - 必须显式调用
handler(ctx, req)才会真正执行业务逻辑,不调就等于阻断请求 - 错误要原样返回,否则上层 gRPC 状态码会丢失(比如把
status.Error(codes.NotFound, ...)包成普通error就失效)
示例:
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器,提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象,支持命名依赖等
func authInterceptor(ctx context.Context, req interface{}, info *grpc.UnaryServerInfo, handler grpc.UnaryHandler) (interface{}, error) {
md, ok := metadata.FromIncomingContext(ctx)
if !ok || len(md["authorization"]) == 0 {
return nil, status.Error(codes.Unauthenticated, "missing auth header")
}
return handler(ctx, req)
}
server := grpc.NewServer(grpc.UnaryInterceptor(authInterceptor))
gRPC 客户端拦截器怎么启用
客户端拦截器常用于自动注入 token、记录出向耗时、做重试决策,但容易忽略上下文传递和并发安全问题。
- 签名是
grpc.UnaryClientInterceptor,注意第 6 个参数是grpc.UnaryInvoker,不是handler - 所有修改必须通过
metadata.AppendToOutgoingContext写入ctx,直接改req或opts无效 - 不要在拦截器里做阻塞操作(如 HTTP 调用、数据库查询),它运行在每次 RPC 调用路径上,会拖慢整个客户端
- 若需链式多个拦截器(比如先加 auth,再记 log),用
grpc-middleware.ChainUnaryClient,别手动嵌套
示例:
func timeoutInterceptor(ctx context.Context, method string, req, reply interface{}, cc *grpc.ClientConn, invoker grpc.UnaryInvoker, opts ...grpc.CallOption) error {
ctx, cancel := context.WithTimeout(ctx, 5*time.Second)
defer cancel()
return invoker(ctx, method, req, reply, cc, opts...)
}
conn, _ := grpc.Dial("localhost:50051", grpc.WithInsecure(), grpc.WithUnaryInterceptor(timeoutInterceptor))
net/rpc 怎么“模拟”拦截逻辑
如果你被 legacy 项目困在 net/rpc,又不能立刻升级 gRPC,那就得接受“模拟”事实——没有真正的拦截点,只有两种可控切面:
立即学习“go语言免费学习笔记(深入)”;
- 在业务方法内部统一调用
before()/after(),靠服务结构体字段(如*log.Logger、tracer)共享依赖 - 用结构体嵌入 + 方法包装(装饰器模式):定义
type loggedUserService struct{ *UserService },然后重写每个导出方法,在调用前/后插逻辑 - 绝对不要碰
rpc.Server.ServeCodec或包装io.ReadWriteCloser:你拿不到方法名和参数结构,gob 编码无公开 schema,Go 版本一升级就崩 - receiver 必须是指针类型,否则
reflect.Value.Call会 panic;方法名必须首字母大写,否则反射不可见
多个拦截器怎么组合不踩坑
真实服务往往需要日志 + 鉴权 + recover + metrics,但 gRPC 原生只允许注册一个 UnaryInterceptor。直接手写嵌套易出错,推荐用 go-grpc-middleware。
- 服务端组合:
grpc.UnaryInterceptor(ChainUnaryServer(recovery.UnaryServerInterceptor(), auth.UnaryServerInterceptor(), logging.UnaryServerInterceptor())) - 顺序很重要:recover 要最外层(捕获 panic),鉴权通常在第二层(避免无效请求进业务),日志放最里或最外依需求
- 别自己实现链式调用:漏掉
return、错误未透传、context 未正确传递都会导致静默失败 - 流式拦截器(
StreamInterceptor)不能和一元混用,必须单独注册,且签名完全不同,别复制粘贴错类型

















