ShardingSphere-JDBC + MyBatisPlus 插入报错：表不存在，如何定位与解决？

Question

在使用ShardingSphere-JDBC与MyBatisPlus时，若插入操作报“表不存在”错误，可能是以下原因：1) 数据分片配置错误，逻辑表未正确映射到实际物理表；2) 物理表未按分片规则创建；3) 数据源配置有误，连接的数据库中缺少对应表。 解决方法：首先确认ShardingSphere的分片策略配置（如sharding-key、分片算法）是否正确。其次检查各数据源中物理表是否按规则生成。可通过执行SQL `SHOW TABLES` 验证。最后，确保MyBatisPlus的Mapper文件及实体类字段与数据库表结构一致。如果使用动态数据源，还需验证数据源切换逻辑是否准确。通过以上步骤，可有效定位并解决问题。此外，开启ShardingSphere的日志功能，查看详细SQL执行路径，有助于快速排查问题。

Answer 1

1. 初步了解问题

在使用ShardingSphere-JDBC与MyBatisPlus时，如果插入操作报“表不存在”错误，这通常意味着逻辑表或物理表的映射出现了问题。以下是可能的原因：

• 数据分片配置错误，导致逻辑表无法正确映射到实际物理表。
• 物理表未按照分片规则创建。
• 数据源配置有误，连接的数据库中缺少对应表。

为了解决这个问题，我们需要从以下几个方面入手：

2. 深入分析原因

以下是从技术深度和广度上对问题的进一步分析：

1. 分片策略配置检查：确认ShardingSphere的分片策略是否正确，包括sharding-key和分片算法。
2. 物理表验证：检查各数据源中的物理表是否按规则生成，可以执行SQL命令 SHOW TABLES 进行验证。
3. Mapper文件及实体类字段一致性：确保MyBatisPlus的Mapper文件和实体类字段与数据库表结构一致。
4. 动态数据源切换逻辑：如果使用了动态数据源，还需要验证数据源切换逻辑是否准确。

此外，开启ShardingSphere的日志功能可以帮助我们查看详细的SQL执行路径，从而快速定位问题。

3. 解决方案步骤

以下是解决问题的具体步骤：

步骤	描述
1	检查ShardingSphere的分片策略配置，确保sharding-key和分片算法设置正确。
2	通过执行SQL SHOW TABLES 验证各数据源中的物理表是否按规则生成。
3	核对MyBatisPlus的Mapper文件和实体类字段，确保其与数据库表结构一致。
4	如果是动态数据源，验证数据源切换逻辑是否正确。

4. 日志排查与流程图

为了更直观地理解整个排查过程，我们可以借助流程图来展示：

graph TD;
    A[开始] --> B[检查分片策略];
    B --> C{分片策略正确?};
    C --否--> D[修正分片策略];
    C --是--> E[验证物理表];
    E --> F{物理表存在?};
    F --否--> G[创建物理表];
    F --是--> H[检查Mapper和实体类];
    H --> I{字段一致?};
    I --否--> J[调整Mapper和实体类];
    I --是--> K[验证动态数据源];
    K --> L{切换逻辑正确?};
    L --否--> M[修正切换逻辑];
    L --是--> N[完成];
    

同时，可以通过开启ShardingSphere的日志功能，记录并分析SQL执行路径，例如：

# 开启日志配置
logging.level.io.shardingsphere = DEBUG