Spring Boot 2.x集成Brave MySQL Instrumentation至Zipkin的问题咨询

既然你已经让MySQL拦截器正常跑起来了，但肯定是碰到了诸如Span没关联到HTTP请求链路、SQL内容没正确捕获、部分数据库操作没生成Span这类典型问题，我给你梳理几个关键的排查和修复点：

1. 确保MySQL Span和父HTTP链路正确关联 #

如果MySQL的Span和上游HTTP请求的Span完全脱节，大概率是Tracing实例没有和Sleuth共享。你要保证TracingConfiguration里用的是Sleuth提供的Tracing bean，而不是自己新建：

@Configuration
public class TracingConfiguration {
    // 注入Sleuth已经配置好的Tracing实例
    @Autowired
    private Tracing sleuthTracing;

    @Bean
    public MySQLStatementInterceptor statementInterceptor() {
        return new MySQLStatementInterceptor(sleuthTracing);
    }
}

同时检查数据源配置，确保拦截器被正确挂载到MySQL连接上，比如用DataSourceBuilder构建时要在JDBC URL里添加拦截器参数：

@Bean
public DataSource dataSource() {
    return DataSourceBuilder.create()
            .url("jdbc:mysql://localhost:3306/test?statementInterceptors=brave.mysql.MySQLStatementInterceptor")
            .username("root")
            .password("your-password")
            .driverClassName("com.mysql.cj.jdbc.Driver")
            .build();
}

2. 捕获完整的SQL查询（含参数） #

默认情况下，Brave会隐藏SQL里的参数值，如果需要展示完整的查询内容（适合调试环境），可以开启参数记录：

@Bean
public MySQLStatementInterceptor statementInterceptor() {
    MySQLStatementInterceptor interceptor = new MySQLStatementInterceptor(sleuthTracing);
    interceptor.setIncludeParameterValues(true); // 开启参数捕获
    return interceptor;
}

⚠️ 注意：生产环境别开这个，避免敏感数据（比如密码、手机号）泄露到Zipkin里。

3. 确保所有数据库操作都生成Span #

如果批量更新、存储过程调用这类操作没生成Span，要检查你的ORM框架（比如MyBatis、JPA）是否复用了配置好拦截器的DataSource：
比如MyBatis的配置：

@Bean
public SqlSessionFactory sqlSessionFactory(DataSource dataSource) throws Exception {
    SqlSessionFactoryBean sessionFactory = new SqlSessionFactoryBean();
    sessionFactory.setDataSource(dataSource); // 必须用配置了拦截器的数据源
    // 其他MyBatis配置，比如Mapper扫描、XML路径
    return sessionFactory.getObject();
}

如果用了连接池（比如HikariCP），可以手动给连接池添加拦截器参数，确保连接池不会绕过配置：

spring.datasource.hikari.connection-properties=statementInterceptors=brave.mysql.MySQLStatementInterceptor

4. 排查Span不上报Zipkin的问题 #

如果MySQL Span生成了但没出现在Zipkin后台，别自己自定义Reporter bean，Sleuth已经默认配置了Zipkin的Reporter，自定义会导致冲突。确保你的Tracing实例完全依赖Sleuth的自动配置，不要额外指定Reporter。

最后补个小提示：Spring Boot 2.x搭配Sleuth 3.x及以上版本时，Brave已经集成在Sleuth里了，你不需要额外引入brave-mysql依赖，只需要在JDBC URL里添加拦截器参数就能自动生效，省掉不少配置工作量。

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