Spring Boot集成Sleuth时Bean类型冲突问题及部分链路追踪配置求助

我完全懂你现在的困扰——Sleuth的自动配置虽然方便，但默认会给JDBC、Kafka生产者、Redis这些组件都套上追踪包装，很容易和现有Bean的类型不匹配，导致那种恼人的BeanNotOfRequiredTypeException。咱们不用改遍所有Bean的类型，通过精准配置就能只开启你需要的HTTP和Kafka消费者追踪，具体可以这么操作：

1. 精准禁用不需要的Sleuth自动配置类 #

Sleuth针对不同组件有单独的自动配置类，咱们直接排除掉不需要的那些就行：

• 在启动类上通过@SpringBootApplication的exclude属性排除：

@SpringBootApplication(exclude = {
    TracingKafkaAutoConfiguration.class, // 禁用Kafka生产者的追踪包装
    SleuthJdbcAutoConfiguration.class, // 禁用JDBC的追踪包装
    SleuthRedisAutoConfiguration.class // 禁用Redis的追踪包装
})
public class YourApplication {
    public static void main(String[] args) {
        SpringApplication.run(YourApplication.class, args);
    }
}

• 或者在配置文件（application.yml或application.properties）里配置：

spring:
  autoconfigure:
    exclude:
      - org.springframework.cloud.sleuth.autoconfig.TracingKafkaAutoConfiguration
      - org.springframework.cloud.sleuth.autoconfig.instrument.jdbc.SleuthJdbcAutoConfiguration
      - org.springframework.cloud.sleuth.autoconfig.instrument.redis.SleuthRedisAutoConfiguration

2. 确保需要的追踪功能保留开启 #

不用额外配置，因为以下两个组件的追踪默认是开启的，而且咱们没排除对应的自动配置类：

• HTTP请求追踪：由SleuthWebAutoConfiguration负责，默认生效，会自动给HTTP请求加上链路追踪
• Kafka消费者追踪：由TracingKafkaConsumerAutoConfiguration负责，默认生效，会包装Kafka消费者实现链路追踪

3. 通过配置文件细化开关（可选） #

如果想更灵活地控制，也可以直接在配置文件里单独关闭不需要的组件追踪：

spring:
  sleuth:
    instrumentation:
      kafka:
        producer: false # 关闭Kafka生产者追踪
        consumer: true # 确保Kafka消费者追踪开启
      jdbc: false # 关闭JDBC追踪
      redis: false # 关闭Redis追踪
      web: true # 确保HTTP请求追踪开启

4. 极端情况：手动指定优先Bean #

如果上面的配置还是没解决类型冲突，你可以手动创建原始的Bean并加上@Primary注解，让Spring优先使用你定义的Bean，而不是Sleuth包装后的版本。比如针对Kafka生产者：

@Configuration
public class KafkaProducerConfig {
    @Primary
    @Bean
    public KafkaProducer<String, Object> kafkaProducer() {
        // 这里写你原来的KafkaProducer创建逻辑
        return new KafkaProducer<>(yourProducerConfigs);
    }
}

这样配置后，就只会对HTTP请求和Kafka消费者进行链路追踪，其他组件不会被Sleuth自动包装，自然也就不会出现类型不匹配的问题了。

内容来源于stack exchange