management.tracing.sampling.probability在微服务中无法使用的解决方法

• 检查依赖完整性
  注册中心可能默认包含了链路追踪相关依赖，但微服务需要显式引入对应包，版本要和Spring Boot/Spring Cloud版本匹配：

  <!-- Spring Boot 3+ 环境 -->
  <dependency>
      <groupId>io.micrometer</groupId>
      <artifactId>micrometer-tracing-bridge-brave</artifactId>
  </dependency>
  <dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-actuator</artifactId>
  </dependency>
  
  <!-- Spring Boot 2.x 环境用Spring Cloud Sleuth -->
  <dependency>
      <groupId>org.springframework.cloud</groupId>
      <artifactId>spring-cloud-starter-sleuth</artifactId>
  </dependency>
  

• 验证配置文件合法性
  确认微服务的YAML文件（application.yml/bootstrap.yml）没有语法错误，比如缩进错误、冒号后缺失空格；如果是多环境配置，要检查当前激活的环境配置文件中是否正确写入了该属性。

• 检查配置元数据与生效情况
  如果IDE不提示该属性，可引入配置元数据依赖：

  <dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-configuration-processor</artifactId>
      <optional>true</optional>
  </dependency>
  

  手动写入management.tracing.sampling.probability: 1.0后，启动服务，通过/actuator/env端点搜索tracing.sampling.probability，确认属性是否被加载。

• 排查配置覆盖问题
  检查是否存在系统环境变量、命令行参数、远程配置中心的配置覆盖了本地YAML的设置——这些配置的优先级更高。通过/actuator/env端点可以查看属性的实际来源。

• 确认WebClient的Trace配置
  如果自定义了WebClient，必须手动加入Trace拦截器，否则采样配置无法生效：

  @Bean
  public WebClient webClient(TracingClientHttpRequestInterceptor tracingInterceptor) {
      return WebClient.builder()
              .filter(tracingInterceptor)
              .build();
  }
  

  Spring Boot 3+的自动配置WebClient默认包含拦截器，但自定义实例需手动添加。

• 日志验证采样效果
  开启链路追踪日志：

  # Spring Boot 3+
  logging.level.io.micrometer.tracing: DEBUG
  # Spring Boot 2.x
  logging.level.org.springframework.cloud.sleuth: DEBUG
  

  启动服务后，查看日志是否生成Trace ID，以此验证采样配置是否生效。

内容的提问来源于stack exchange，提问作者java beginner