源码·XID 传播：跨 RPC 的事务上下文
2026/8/22大约 2 分钟
分布式事务系列 · 阶段 3B · Seata AT 源码 · 第 19/49 篇 · 🚧 占位待学
上一篇：《源码·TM 侧：从注解拦截到全局事务开启》
下一篇：《源码·RM 一阶段：数据源代理、镜像生成与全局锁》
学习大纲：《分布式事务学习总纲》
状态：待学习。 本文为占位文档：知识点清单、实验与验收标准已就绪，正文待按「先学习、先实验、再撰写」补全。
对应总纲单元：阶段 3B · 单元 3B.2
一、本文要解决的问题
XID 存放在哪？怎么跨 Dubbo / Feign / HTTP 传给下游？为什么异步线程里它常常神秘消失？
二、知识点清单
- RootContext.bind / unbind 与 ThreadLocal 事务上下文
- 各 RPC 框架的 filter 链：请求带出 XID、下游解析并绑定
- 跨线程 / 线程池 / @Async 场景的上下文丢失与传递方案
三、动手实验（学习时必须真跑）
- 断点观察 XID 在 filter 链中的完整传递过程
- 复现「线程池里丢 XID」问题，再修复并验证
四、验收标准（全部通过才进入下一篇）
五、写作提示（补正文时遵守）
- 开篇问题驱动；结构走「是什么 → 为什么 → 怎么做 → 背景知识」
- 所有代码、命令、输出必须先在本机跑通再写入，不得杜撰
- 版本口径以总纲环境清单为准（Apache Seata 2.6.0 / MySQL 8.0 / RocketMQ 5.x / Spring Boot 3.x）
- 涉及版本敏感结论时标注出处与时间
本篇完成后，把文首导航块的「🚧 占位待学」去掉，并在总纲处打卡。