【记】研究Sharding-JDBC遇到的一个异常(Caused by: io.shardingsphere.core.exception.ShardingException: Cannot get ...-优快云博客

本文详细解析了ShardingSphere中因表元数据不一致导致的ShardingException异常，并通过跟踪源码定位问题，最终确认为实际表结构与配置不符，提供了具体的解决步骤。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

一、异常信息

Caused by: io.shardingsphere.core.exception.ShardingException: Cannot get uniformed table structure for `t`. The different meta data of actual tables are as follows

异常信息提示找不到表的元数据信息，也就是找不到表，但是数据表实际已经创建。

这个异常信息网上基本搜不到有效的信息和解决方案

二、排查过程

at io.shardingsphere.core.metadata.table.executor.TableMetaDataLoader.checkUniformed(TableMetaDataLoader.java:136)
at io.shardingsphere.core.metadata.table.executor.TableMetaDataLoader.load(TableMetaDataLoader.java:68)
at io.shardingsphere.core.metadata.table.executor.TableMetaDataLoader.load(TableMetaDataLoader.java:63)

private TableMetaData load(final TableRule tableRule, final ShardingDataSourceNames shardingDataSourceNames) {
    List<TableMetaData> actualTableMetaDataList = loadActualTableMetaDataList(tableRule.getActualDataNodes(), shardingDataSourceNames);
    checkUniformed(tableRule.getLogicTable(), actualTableMetaDataList);
    return actualTableMetaDataList.iterator().next();
}

上述为异常栈信息，通过跟踪源码的方式发现最下面load方法中的 tableRule.getActualDataNodes()返回的是t0、t1两个数据，分表的配置也是：actual-data-nodes=ds_0.t$->{0..1}

根据上述信息分析发现，配置的表是t0,t1，但是数据库实际只创建了t0表，所以抛出上述异常，再创建t1表即可解决问题

三、总结

使用第三方库遇到问题网上又找不到有效的解决方案时，可尝试通过跟踪源码的方式找到问题原因