Java gRPC服务端如何在业务运行时获取请求头Metadata？

推荐方案：使用gRPC Context传递请求头数据 #

这是gRPC官方推荐的请求上下文传递方式，完全适配gRPC的请求生命周期，线程安全，不会出现并发请求数据覆盖的问题，性能也远高于Redis存取的方式。

实现步骤：

1. 定义Context.Key：用来标识要存储的请求头数据

public class GrpcContextHolder {
    // 根据实际需求定义Key，这里以客户端token为例
    public static final Context.Key<String> CLIENT_TOKEN = Context.key("client-token");
}

2. 自定义ServerInterceptor拦截请求头并写入Context

public class MetadataTransferInterceptor implements ServerInterceptor {
    @Override
    public <ReqT, RespT> ServerCall.Listener<ReqT> interceptCall(ServerCall<ReqT, RespT> call, Metadata headers, ServerCallHandler<ReqT, RespT> next) {
        // 从请求头中提取需要的数据，这里以"client-token"为例
        Metadata.Key<String> tokenKey = Metadata.Key.of("client-token", Metadata.ASCII_STRING_MARSHALLER);
        String clientToken = headers.get(tokenKey);
        
        // 将数据存入当前请求的Context
        Context currentContext = Context.current().withValue(GrpcContextHolder.CLIENT_TOKEN, clientToken);
        
        // 用携带数据的Context执行后续调用链
        return Contexts.interceptCall(currentContext, call, headers, next);
    }
}

3. 在业务逻辑中直接获取数据
   在你的gRPC实现类的业务方法里，直接通过Context.Key取出数据即可，无需额外传递参数：

public class BizServiceImpl extends BizServiceGrpc.BizServiceImplBase {
    @Override
    public void processBiz(BizRequest request, StreamObserver<BizResponse> responseObserver) {
        // 从Context中获取请求头里的token
        String clientToken = GrpcContextHolder.CLIENT_TOKEN.get();
        
        // 这里直接使用clientToken处理业务逻辑，完全和当前请求绑定
        // ...
        
        responseObserver.onNext(BizResponse.newBuilder().build());
        responseObserver.onCompleted();
    }
}

方案优势：

• 完全和gRPC请求生命周期绑定，每个请求的Context独立，并发请求不会互相干扰，彻底解决Redis存储的覆盖问题
• 无需额外中间存储，性能损耗极低
• 代码侵入性小，业务逻辑无需修改方法签名，只需直接读取Context即可

其他不推荐的方案（供参考） #

• ThreadLocal存储：gRPC使用线程池复用线程，若手动使用ThreadLocal，需要在请求结束后强制清理，否则会出现线程复用导致的数据串流或内存泄漏问题，维护成本高，不如Context可靠
• 修改请求对象传递：需要修改proto文件，在请求体中添加请求头相关字段，侵入性极强，破坏了请求体的语义，不推荐

内容的提问来源于stack exchange，提问作者Java_Baby