Sharding-JDBC范围分表失效问题排查指南
本文旨在帮助您解决Spring Boot（例如，若依框架）和MySQL环境下，使用Sharding-JDBC进行范围分表时，分表功能失效的问题。 问题表现为：SQL语句未命中预期分表。
问题分析与定位
以下几个方面可能导致Sharding-JDBC范围分表失效：
-
自定义分片算法(MyRangeShardingAlgorithm)逻辑错误:
doSharding方法中，虽然包含日志打印，但关键在于routTables集合是否正确构建了所有目标表名。getTableNames方法的边界条件处理（特别是起始日期和结束日期）需要仔细检查，确保所有目标月份的表名都被正确包含。 务必仔细检查before方法的判断逻辑以及calendar.add(Calendar.MONTH, 1)后月份是否溢出。 -
YAML配置与实际表名不匹配:
actual-data-nodes中定义的分表规则（例如lyg_tsvol-${2023..2024}0-${1..9}）必须与MyRangeShardingAlgorithm生成的表名完全一致。 仔细核对算法生成的表名与YAML配置中的模式是否匹配，尤其注意-符号的含义和使用方式。 -
createtime字段数据类型或值异常: 分表策略依赖于createtime字段。 请确认数据库中createtime字段的数据类型为Timestamp，且数据值符合预期，避免数据类型不匹配或数据异常导致分表失效。 -
SQL语句直接命中逻辑表名: 如果SQL语句（例如
SELECT count(0) FROM lyg_tsvol a ...）直接使用了逻辑表名lyg_tsvol，则说明Sharding-JDBC的分片规则未生效，SQL语句未被路由到实际分表。 -
Sharding-JDBC配置不完整或错误: 检查
ShardingDataSourceConfig中的配置是否完整且正确。 尤其关注createTableRule方法，确保生成的TableRuleConfiguration正确配置了分片策略（包括MyPreciseShardingAlgorithm和MyRangeShardingAlgorithm）。 同时，验证shardingDataSource方法是否正确创建了Sharding数据源。 -
多数据源配置问题:
DruidConfig中的多数据源配置必须保证DataSourceType.SHARDING能够正确选择Sharding数据源。 -
Sharding-JDBC初始化或生效失败: 如果以上步骤都未发现问题，则可能Sharding-JDBC未正确初始化或生效。
排查步骤建议
-
检查日志: 仔细检查Sharding-JDBC的日志，查找错误信息或异常。 确保日志级别足够详细，以便获取更多信息。
-
简化测试: 创建一个简单的测试用例，只包含一个表和简单的分片规则，验证Sharding-JDBC是否能够正常工作。 这有助于隔离问题。
-
断点调试: 使用调试器逐步跟踪代码执行，尤其关注
MyRangeShardingAlgorithm和ShardingDataSourceConfig中的代码，检查每一步的结果是否符合预期。 特别关注rangeShardingValue.getLogicTableName()和rangeShardingValue.getValueRange()的值。
通过仔细检查以上内容，结合日志和调试信息，您应该能够找到Sharding-JDBC范围分表失效的根本原因。 重点关注自定义分片算法的逻辑正确性以及YAML配置与算法生成的表名的一致性。
