Spring Boot 3中如何初始化Micrometer/Brave Baggage字段？

一、当前方案是否为最优解？ #

当前方案不算最优，核心问题在于依赖SpanHandler的begin方法初始化Baggage，但这个逻辑的执行完全绑定Span的采样状态。如果你的Trace采样率不是100%，未被采样的Span不会触发这段初始化代码，这也是你去掉alwaysSampleLocal()后初始化偶尔失效的原因。

更合理的思路是在请求入口阶段直接处理Baggage初始化，比如通过WebFilter拦截HTTP请求，在请求刚进入服务时就检查并设置Baggage字段。这种方式不依赖Span采样，能确保每个请求都完成Baggage初始化，逻辑也更直接清晰。

优化后的代码示例：

@Component
public class FAPIInteractionIdFilter implements Filter {

    private static final BaggageField FIELD = BaggageField.create("x-fapi-interaction-id");
    private final UniqueIdGenerator generator;

    public FAPIInteractionIdFilter(UniqueIdGenerator generator) {
        this.generator = generator;
    }

    @Override
    public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain) throws IOException, ServletException {
        HttpServletRequest httpRequest = (HttpServletRequest) request;
        String interactionId = httpRequest.getHeader("x-fapi-interaction-id");
        
        if (interactionId == null || interactionId.trim().isEmpty()) {
            interactionId = generator.next();
            FIELD.updateValue(TraceContext.current(), interactionId);
        }
        
        chain.doFilter(request, response);
    }
}

同时保留原有的BaggagePropagationCustomizer配置，确保Baggage能在服务间正常传播：

@Bean
BaggagePropagationCustomizer fapiBaggagePropagationCustomizer() {
    return builder -> builder.add(BaggagePropagationConfig.SingleBaggageField.remote(FIELD));
}

二、alwaysSampleLocal()的性能负面影响 #

alwaysSampleLocal()会强制对所有本地Span进行采样，开启后会带来明显的性能开销：

1. 存储压力剧增：所有本地Span都会被上报到Trace系统（如Jaeger、Zipkin），高流量场景下会大幅增加存储成本和后端处理压力。
2. 资源占用提升：每个Span都需要创建、序列化和传输，高并发时会占用更多CPU和内存，直接影响服务的响应性能。

你去掉该方法后初始化偶尔生效，本质是未被采样的Span不会触发SpanHandler的begin方法，导致Baggage未被初始化。所以根本解决办法是换用不依赖Span采样的初始化方式（比如上面的WebFilter方案），而非强制采样所有本地Span。

内容的提问来源于stack exchange，提问作者Víctor Herraiz