如何在Spring Boot命令行运行器（Command Line Runner）中配置Spring Cloud Sleuth的Baggage字段并实现链路追踪？

当然可以实现！在Spring Boot命令行运行器应用里集成Spring Cloud Sleuth完全可行——只是因为没有HTTP请求触发自动创建trace和span上下文，你需要手动初始化这些内容就行。下面一步步教你怎么操作：

1. 手动创建根Trace/Span #

因为你的应用不在HTTP请求链路中，得显式创建根Span来建立trace上下文，用Spring Cloud Sleuth提供的Tracer bean就能搞定：

import org.springframework.boot.CommandLineRunner;
import org.springframework.stereotype.Component;
import brave.Tracer;
import brave.Span;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

@Component
public class CustomCommandLineRunner implements CommandLineRunner {

    private static final Logger log = LoggerFactory.getLogger(CustomCommandLineRunner.class);
    private final Tracer tracer;

    // 通过构造注入Tracer
    public CustomCommandLineRunner(Tracer tracer) {
        this.tracer = tracer;
    }

    @Override
    public void run(String... args) throws Exception {
        // 创建根Span并命名，比如对应命令行任务的名称
        Span rootSpan = tracer.nextSpan().name("command-line-task-root").start();
        try (Tracer.SpanInScope scope = tracer.withSpanInScope(rootSpan)) {
            // 在这里执行你的业务逻辑，日志、调用其他服务都会自动关联trace信息
            executeBusinessLogic();
        } finally {
            // 务必在finally块结束Span，避免资源泄漏和不完整的trace
            rootSpan.finish();
        }
    }

    private void executeBusinessLogic() {
        // 此时日志会自动带上traceId、spanId字段
        log.info("开始执行命令行任务的业务逻辑");
        // 如果调用其他微服务，Sleuth会自动把trace相关Header加入请求
        // restTemplate.getForObject("http://your-microservice/api/xxx", String.class);
    }
}

2. 确认日志配置 #

你已经用了%X格式的日志配置，这里再确认一下（以Logback为例），确保pattern包含Sleuth的MDC字段：

<appender name="CONSOLE" class="ch.qos.logback.core.ConsoleAppender">
    <encoder>
        <pattern>%d{HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg [%X{traceId},%X{spanId}]%n</pattern>
    </encoder>
</appender>

当Span上下文激活后，日志里就会自动填充traceId和spanId，和你的微服务日志格式保持一致。

3. 向下游服务传播Trace上下文 #

如果你的命令行应用需要调用其他Spring Cloud微服务，只要你用的是Sleuth自动配置的客户端（比如RestTemplate、WebClient或者Feign客户端），Sleuth会自动把trace相关的Header（比如X-B3-TraceId、X-B3-SpanId）添加到请求里，保证整个trace链路完整。

4. 可选配置调整 #

你可以在application.yml里调整Sleuth的行为，比如：

spring:
  sleuth:
    sampler:
      probability: 1.0 # 命令行应用建议设为100%采样率，没必要跳过任何trace
    # 可选：如果需要自定义traceId生成规则，可以指定自定义生成器
    # trace-id-generator: com.yourpackage.CustomTraceIdGenerator

注意事项 #

• 一定要在finally块里结束Span，避免内存泄漏和不完整的trace记录
• 如果业务逻辑里有嵌套方法调用，只要Span上下文处于激活状态，Sleuth会自动创建子Span
• 如果用了异步任务，要使用Sleuth提供的异步工具类（比如TraceableExecutorService）来传递Span上下文到异步线程中

内容的提问来源于stack exchange，提问作者Ryan Whitcomb