如何应用 provides with 模式实现对分布式日志追踪变量 MDC 的跨模块传递

云雪吖_5118

云雪吖_5118

2026-05-23

361人浏览

原创

不存在“provides with模式”,分布式追踪中traceid传递依赖入口注入、跨服务透传和跨线程延续三类动作,需通过mdc、http头及transmittablethreadlocal等机制实现。

如何应用 provides with 模式实现对分布式日志追踪变量 mdc 的跨模块传递

“provides with 模式”并不是 Java 或 Spring 生态中标准术语,当前主流框架(Spring Boot、SLF4J、Logback)及分布式追踪实践(如 SkyWalking、OpenTelemetry)中均无官方定义的 provides with 模式。你提到的表述,极可能是对某种配置写法、依赖注入风格或文档翻译偏差的误记——比如混淆了 Spring 的 @Bean 方法签名中的 provides(常见于 Kotlin DSL 或某些构建工具描述),或误将 “propagates with”(即“携带传递”)听/读作 “provides with”。

真正起作用的是 traceId 的跨模块“传递机制”,不是“provides with”

在分布式日志追踪中,MDC 中的 traceId 要贯穿网关、服务、Feign 调用、线程池子线程等场景,靠的是明确的三类传递动作:

  • 入口注入:在请求最开始(如网关 Filter 或 Spring WebMvc HandlerInterceptor)生成 traceId,并调用 MDC.put("traceId", id)
  • 跨服务透传:通过 HTTP Header(如 X-Trace-ID)将 ID 发送给下游;下游收到后再次 MDC.put 绑定到当前线程
  • 跨线程延续:主线程的 MDC 内容默认不会进入线程池子线程(因 ThreadLocal 隔离)。必须借助 TransmittableThreadLocal + TtlRunnable/TtlCallable 包装任务,或使用已集成 TTL 的线程池(如 TtlExecutors.getTtlExecutorService)

各模块如何协作完成 traceId 传递

无需虚构“provides with”,只需按职责分层实现:

  • 网关模块:添加 OncePerRequestFilter,生成 UUID 作为 traceId,写入 MDC,同时塞进 HttpServletResponse header 向下游转发
  • 业务服务模块:
    • 注册 HandlerInterceptor 接收 header 中的 X-Trace-ID,存入 MDC
    • 配置 FeignClient 的 RequestInterceptor,自动从当前 MDC 取 traceId 并设为请求头
  • 异步模块(@Async / 线程池):
    • 替换默认 MDCAdapter 为 TtlMDCAdapter(继承自 ch.qos.logback.classic.util.LogbackMDCAdapter)
    • 所有提交到线程池的任务,必须用 TtlRunnable.get(runnable) 包装;若用 @Async,需自定义 AsyncConfigurer 返回基于 TTL 的 ThreadPoolTaskExecutor

关键配置示例(Logback + TTL)

确保日志格式含 traceId:

%d{HH:mm:ss.SSS} [%thread] %-5level [%X{traceId}] %logger{36} - %msg%n

并在启动类或配置类中指定 MDC Adapter:

System.setProperty("logback.mdc.adapter", "com.example.TtlMDCAdapter");

其中 TtlMDCAdapter 内部使用 TransmittableThreadLocal<map string>></map> 替代原生 ThreadLocal,使 map 可跨线程继承。

不依赖“模式”,依赖契约与包装

所谓“跨模块传递”,本质是各模块遵守同一契约:
→ 入口统一注入
→ 远程调用统一透传 header
→ 异步执行统一包装任务
没有魔法模式,只有清晰的责任划分和必要的适配封装。

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
java
java

Java是一个通用术语,用于表示Java软件及其组件,包括“Java运行时环境 (JRE)”、“Java虚拟机 (JVM)”以及“插件”。php中文网还为大家带了Java相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

2023.06.15

10657

6

java正则表达式语法
java正则表达式语法

java正则表达式语法是一种模式匹配工具,它非常有用,可以在处理文本和字符串时快速地查找、替换、验证和提取特定的模式和数据。本专题提供java正则表达式语法的相关文章、下载和专题,供大家免费下载体验。

2023.07.05

7782

9

java自学难吗
java自学难吗

Java自学并不难。Java语言相对于其他一些编程语言而言,有着较为简洁和易读的语法,本专题为大家提供java自学难吗相关的文章,大家可以免费体验。

2023.07.31

6772

8

java配置jdk环境变量
java配置jdk环境变量

Java是一种广泛使用的高级编程语言,用于开发各种类型的应用程序。为了能够在计算机上正确运行和编译Java代码,需要正确配置Java Development Kit(JDK)环境变量。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.01

1144

3

java保留两位小数
java保留两位小数

Java是一种广泛应用于编程领域的高级编程语言。在Java中,保留两位小数是指在进行数值计算或输出时,限制小数部分只有两位有效数字,并将多余的位数进行四舍五入或截取。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.02

948

3

java基本数据类型
java基本数据类型

java基本数据类型有:1、byte;2、short;3、int;4、long;5、float;6、double;7、char;8、boolean。本专题为大家提供java基本数据类型的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

1396

5

java有什么用
java有什么用

java可以开发应用程序、移动应用、Web应用、企业级应用、嵌入式系统等方面。本专题为大家提供java有什么用的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

2809

5

java在线网站
java在线网站

Java在线网站是指提供Java编程学习、实践和交流平台的网络服务。近年来,随着Java语言在软件开发领域的广泛应用,越来越多的人对Java编程感兴趣,并希望能够通过在线网站来学习和提高自己的Java编程技能。php中文网给大家带来了相关的视频、教程以及文章,欢迎大家前来学习阅读和下载。

2023.08.03

20111

3

配置java环境变量
配置java环境变量

配置Java环境变量是为了让操作系统能够识别和使用Java的相关命令和功能。本专题为大家提供配置java环境变量相关文章,帮助大家解决问题。

2023.08.03

1235

8

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
热门推荐
/
最新课程
phpStudy极速入门视频教程
phpStudy极速入门视频教程

共6课时 | 54.7万人学习

独孤九贱(4)_PHP视频教程
独孤九贱(4)_PHP视频教程

共89课时 | 133.7万人学习