该文章内容发布已经超过一年,请注意检查文章中内容是否过时。

Dubbo 上下文信息

介绍Dubbo上下文信息的作用、应用场景、使用方式以及注意事项

简介

上下文信息是一次 RPC 调用过程中附带的环境信息,如方法名、参数类型、真实参数、本端/对端地址等。这些数据仅属于一次调用,作用于 Consumer 到 Provider 调用的整个流程。

提供上下文信息是 RPC 框架很重要的一个功能,使用上下文不仅可以为单次调用指定不同配置,还能在此基础上提供强大的上层功能,如分布式链路追踪。其实现原理就是在上下文中维护一个span_id,Consumer 和 Provider 通过传递span_id来连接一次RPC调用,分别上报日志后可以在追踪系统中串联并展示完整的调用流程。这样可以更方便地发现异常,定位问题。

使用说明

Dubbo中代表上下文的类是org.apache.dubbo.rpc.RpcContext,可通过下述代码来获取上下文信息。

RpcContext.getContext()

使用场景

获取调用信息

方法名用途作用范围说明
getRequest获取 RPC 请求对象Consumer获取底层 RPC 请求对象,例如 HttpServletRequest,其他情况为 null
getResponse获取 RPC 请求响应Consumer获取底层 RPC 响应对象,例如HttpServletResponse,其他情况为 null
isProviderSide当前是否属于 Provider 上下文Both服务被调用时为 true,调用其他服务时为false
isConsumerSide当前是否属于 Consumer 上下文Both服务被调用时为 false,调用其他服务时为 true
getUrls获取当前能调用的 Url 列表BothConsumer 端会根据不同的 Failover 策略实时变化
getRemotePort获取远端端口BothConsumer 端为最后一次调用的 Provider 端口,Provider 为当前请求的 Consumer 端口
getRemoteHost获取远端主机地址Both
getRemoteHostName获取远端主机名Both
getRemoteAddressString获取远端地址Both
getRemoteAddress获取远端地址Both
getLocalPort获取本端端口Both
getLocalHost获取本端主机地址Both
getLocalHostName获取本端主机名Both
getLocalAddressString获取本端地址Both
getLocalAddress获取本端地址Both

传递用户参数

本端传递

调用getset方法即可完成参数传递。主要用于本端 Filter 之间的数据共享。

对端传递

调用setAttachmentgetAttachment即可完成对端数据传递,这些数据会经过 RPC 传递到对端。例如 Consumer 向 Provider 传递span_id

  • Dubbo已经支持从 Provider 端向 Consumer 端传递参数,读写方式和 Consumer 端调用时的方式一样。

异步调用

在异步调用时,可通过getCompletableFuturegetFuture获取相关的 Future,异步调用相关文档请参阅:异步调用

注意事项

Dubbo 内部使用 ThreadLocal 的方式存储每次调用的上下文信息,当接收到请求或发起请求时,当前线程会更新 RpcContext。例如,服务 A 调用服务 B,服务 B 调用服务 C,在 B 调 C 之前,RpcContext 记录的是 A 调 B 的信息,在 B 调 C 之后,RpcContext 记录的是 B 调 C 的信息。

最后修改 February 22, 2023: Merge refactor website (#2293) (4517e8c1c9c)