SpringBoot项目里，ShardingSphere-JDBC 5.0.0-alpha与Druid数据源整合的完整避坑指南

SpringBoot项目中ShardingSphere-JDBC 5.0.0-alpha与Druid数据源深度整合实战最近在重构公司分库分表模块时发现ShardingSphere-JDBC 5.0.0-alpha与Druid的整合存在不少隐性坑点。特别是当需要启用Druid监控页面时常规配置方式会导致各种异常。经过两周的源码追踪和实战验证终于梳理出一套可靠方案。1. 环境准备与基础配置陷阱在开始之前先确认你的SpringBoot项目已经包含以下核心依赖dependency groupIdorg.apache.shardingsphere/groupId artifactIdshardingsphere-jdbc-core-spring-boot-starter/artifactId version5.0.0-alpha/version /dependency dependency groupIdcom.alibaba/groupId artifactIddruid-spring-boot-starter/artifactId version1.2.8/version /dependency第一个大坑出现在application.yml的基础配置上。很多教程会建议这样配置spring: shardingsphere: datasource: common: type: com.alibaba.druid.pool.DruidDataSource driver-class-name: com.mysql.cj.jdbc.Driver # 其他Druid参数... names: ds0,ds1 ds0: url: jdbc:mysql://localhost:3306/db0 ds1: url: jdbc:mysql://localhost:3306/db1启动时会直接报错java.lang.IllegalArgumentException: url attribute is mandatory。这是因为DruidAutoConfigure会在ShardingSphere之前初始化而这时还没有配置具体数据源URL。临时解决方案排除Druid自动配置spring: autoconfigure: exclude: com.alibaba.druid.spring.boot.autoconfigure.DruidDataSourceAutoConfigure2. 监控页面失效的根源分析排除自动配置后项目虽然能启动但访问/druid会出现404。这是因为StatViewServlet的自动注册被禁用Druid的监控过滤器未生效YML中的监控配置未被解析通过DEBUG模式追踪源码发现关键点在于DruidStatViewServletConfiguration这个自动配置类被跳过了。该类的生效条件包括ConditionalOnWebApplication ConditionalOnProperty( prefix spring.datasource.druid.stat-view-servlet, name enabled ) ConditionalOnMissingBean(ServletRegistrationBean.class)3. 自定义配置类实现完美整合参考MyBatis动态数据源的实现方式我们需要手动引入关键配置Configuration ConditionalOnClass(DruidDataSource.class) EnableConfigurationProperties(DruidStatProperties.class) Import({ DruidSpringAopConfiguration.class, DruidStatViewServletConfiguration.class, DruidWebStatFilterConfiguration.class, DruidFilterConfiguration.class }) public class DruidShardingJdbcConfig { Bean ConfigurationProperties(spring.datasource.druid) public DruidStatProperties druidStatProperties() { return new DruidStatProperties(); } }这个配置类实现了重新启用被排除的监控Servlet和Filter保持YML配置的优先级兼容ShardingSphere的数据源代理机制4. 完整配置方案与参数调优最终版的application.yml应该包含这些关键部分spring: autoconfigure: exclude: com.alibaba.druid.spring.boot.autoconfigure.DruidDataSourceAutoConfigure datasource: druid: stat-view-servlet: enabled: true login-username: admin login-password: admin allow: 127.0.0.1 web-stat-filter: enabled: true shardingsphere: datasource: common: type: com.alibaba.druid.pool.DruidDataSource initial-size: 5 min-idle: 5 max-active: 20 filters: stat,wall names: ds0,ds1 ds0: url: jdbc:mysql://localhost:3306/db0 ds1: url: jdbc:mysql://localhost:3306/db1对于分库分表场景建议调整以下Druid参数参数名推荐值说明max-active实际连接数 × 1.5考虑分片后的连接膨胀validation-querySELECT 1必须为有效SQLtime-between-eviction-runs-millis30000适当缩短检测间隔5. 生产环境注意事项在实际部署时发现几个关键问题监控页面安全问题必须配置allow/deny规则druid: stat-view-servlet: deny: 192.168.1.100SQL防火墙配置对于分片查询需要特别处理druid: filter: wall: config: multi-statement-allow: true监控数据不准问题需要添加Slf4j过滤器filters: stat,wall,slf4j在压力测试中发现当分片数超过5个时建议将max-active调整为max-active 分片数 × (常规单库建议连接数/2)这套方案已经在我们的订单系统中稳定运行半年日均处理2000万分片查询。最大的收获是明白了自动配置排除后如何手动恢复关键功能这种思路同样适用于其他类似场景。