【业务功能篇】多环境配置、多数据源切换失效@DS解决方式

<think>嗯，用户问的是MyBatis-Plus在多数据源环境下如何配置分页。首先，我需要回忆一下MyBatis-Plus的基本分页配置。通常，单数据源时，我们会添加分页拦截器PaginationInnerInterceptor，这样就能自动处理分页逻辑了。但是多数据源的情况下，每个数据源可能需要自己的分页配置，不能共用同一个拦截器，否则可能会有冲突或者失效的问题。 接下来，我得想想多数据源的配置方法。MyBatis-Plus多数据源通常使用@DS注解来切换数据源，这背后可能是基于动态数据源的路由机制。每个数据源对应的SqlSessionFactory可能不同，因此每个都需要自己的分页拦截器。 用户可能遇到的问题可能是，配置了多个数据源后，分页插件不起作用，或者分页效果不对。这可能是因为他们只在其中一个SqlSessionFactory中配置了分页拦截器，而其他数据源没有配置，或者配置的方式不对。 然后，我需要整理正确的配置步骤。首先，每个数据源对应的配置类中，比如DataSource1Config和DataSource2Config，需要分别创建自己的MybatisPlusInterceptor，并添加PaginationInnerInterceptor。这样每个数据源的SqlSessionFactory都会应用自己的分页插件。 另外，需要提醒用户注意分页参数的正确使用，比如Page对象和正确的数据库方言。不同的数据库可能需要不同的方言设置，虽然MyBatis-Plus通常能自动检测，但在某些情况下可能需要手动指定。 可能用户没有意识到多数据源需要分别配置拦截器，或者他们可能在某个地方漏掉了配置。这时候需要给出示例代码，展示如何为每个数据源单独配置分页插件，确保他们能够正确复制到自己的项目中。 最后，还要考虑是否有可能的其他问题，比如事务管理、其他拦截器的配置是否会影响分页，或者是否有版本兼容性问题。但为了不让回答过于复杂，可能先聚焦在核心配置步骤上，确保用户能够快速解决问题。</think>MyBatis-Plus 在多数据源环境下配置分页时，需要注意 **分页拦截器的独立配置** 和 **数据源隔离**。以下是具体步骤和注意事项： --- ### 1. **核心原理** MyBatis-Plus 的分页功能依赖 `PaginationInnerInterceptor` 拦截器。**多数据源场景下，每个数据源需要独立配置自己的分页拦截器**，避免不同数据源的 SQL 解析冲突。 --- ### 2. **配置步骤** #### 2.1 添加依赖 确保项目中已引入 MyBatis-Plus 和多数据源依赖： ```xml <dependency> <groupId>com.baomidou</groupId> <artifactId>mybatis-plus-boot-starter</artifactId> <version>3.5.3.1</version> </dependency> <dependency> <groupId>com.baomidou</groupId> <artifactId>dynamic-datasource-spring-boot-starter</artifactId> <version>3.6.1</version> </dependency> ``` #### 2.2 配置多数据源 在 `application.yml` 中配置多个数据源： ```yaml spring: datasource: dynamic: primary: master datasource: master: url: jdbc:mysql://localhost:3306/db1 username: root password: 123456 driver-class-name: com.mysql.cj.jdbc.Driver slave: url: jdbc:mysql://localhost:3306/db2 username: root password: 123456 driver-class-name: com.mysql.cj.jdbc.Driver ``` #### 2.3 独立配置分页拦截器 **为每个数据源单独配置分页插件**（关键步骤）： ```java @Configuration public class MyBatisPlusConfig { // 主数据源配置 @Bean @ConfigurationProperties(prefix = "spring.datasource.dynamic.datasource.master") public DataSource masterDataSource() { return DruidDataSourceBuilder.create().build(); } @Bean public SqlSessionFactory masterSqlSessionFactory( @Qualifier("masterDataSource") DataSource dataSource) throws Exception { MybatisSqlSessionFactoryBean factory = new MybatisSqlSessionFactoryBean(); factory.setDataSource(dataSource); // 添加分页拦截器 MybatisPlusInterceptor interceptor = new MybatisPlusInterceptor(); interceptor.addInnerInterceptor(new PaginationInnerInterceptor()); factory.setPlugins(interceptor); return factory.getObject(); } // 从数据源配置（重复类似步骤，替换数据源名称和Bean名称） // @Bean // public DataSource slaveDataSource() { ... } // @Bean // public SqlSessionFactory slaveSqlSessionFactory(...) { ... } } ``` #### 2.4 使用分页 在 Service 层使用 `Page` 对象进行分页查询： ```java @Service public class UserServiceImpl implements UserService { @Autowired private UserMapper userMapper; @DS("master") // 指定数据源 @Override public Page<User> selectPage(Page<User> page) { return userMapper.selectPage(page, null); } @DS("slave") // 切换数据源 @Override public Page<User> selectSlavePage(Page<User> page) { return userMapper.selectPage(page, null); } } ``` --- ### 3. **注意事项** 1. **拦截器隔离**：每个 `SqlSessionFactory` 必须单独配置 `MybatisPlusInterceptor`，避免多数据源共享导致分页失效。 2. **事务管理**：结合 `@Transactional` 注解时，注意事务管理器与数据源的匹配。 3. **方言自动识别**：`PaginationInnerInterceptor` 默认自动检测数据库类型，如有特殊需求可手动指定： ```java new PaginationInnerInterceptor(DbType.MYSQL); ``` --- ### 4. 常见问题 - **分页失效**：检查是否漏配了某个数据源的拦截器。 - **SQL 语法错误**：确保数据库方言配置正确（如 MySQL、PostgreSQL）。 - **动态数据源切换**：使用 `@DS` 注解时，确保 AOP 顺序正确（建议在启动类添加 `@EnableAspectJAutoProxy(exposeProxy = true)`）。 通过以上配置，MyBatis-Plus 可以在多数据源环境下正确实现分页功能。