灰度按请求头 X-Gray-Tag: v2 分流,同步接口有一半落到新版本。异步的下单后处理走线程池,日志里这个头全是空,任务全打到老版本,新版本队列一条消息都没收到。第一次遇到会往复杂处想,其实漏掉的多是个小前提。
TransmittableThreadLocal<String> tag = new TransmittableThreadLocal<>();
TtlExecutors.getTtlExecutorService(pool);
// 提交任务前 tag.set(request.getHeader("X-Gray-Tag"))
请求头存在 ThreadLocal 里,只跟着当前处理线程走,任务提交到线程池后由另一个线程执行,取不到原线程的变量。线程池还会复用线程,上一个请求的标识可能残留,排查时看到的值更乱。这一点先确认清楚,后面就不用反复试。
「灰度标识透传」相关的验证我通常做两遍,改完一次、隔天再看一次,确认不是临时生效。
具体做法是,把灰度标识放进任务对象一起提交 不要依赖线程内变量;提交时用包装器捕获上下文 执行前设置 执行后清理;消息生产端把标识写进消息头 消费端再取出来;验证时看异步链路日志里是否带上标识。
改完照着核一遍,异步任务日志每行都带 X-Gray-Tag,新版本实例的消费量从 0 变成与灰度比例一致。
