mybatis-plus与pageHeper依赖冲突报错解决方法

错误信息：

java.lang.ClassNotFoundException: org.mybatis.spring.boot.autoconfigure.MybatisAutoConfiguration

确认冲突依赖和版本

我这里使用的SpringbBoot版本：3.3.5，冲突的依赖包

注意：是boot3版本的mybatis-plus

        <!-- 集成mybatis-plus -->
        <dependency>
            <groupId>com.baomidou</groupId>
            <artifactId>mybatis-plus-spring-boot3-starter</artifactId>
            <version>3.5.10.1</version>
        </dependency>

        <!-- pagehelper 分页插件 -->
        <dependency>
            <groupId>com.github.pagehelper</groupId>
            <artifactId>pagehelper-spring-boot-starter</artifactId>
            <version>2.1.0</version>
        </dependency>

解决方法

修改pageHeper的依赖

        <!-- pagehelper 分页插件 -->
        <dependency>
            <groupId>com.github.pagehelper</groupId>
            <artifactId>pagehelper-spring-boot-starter</artifactId>
            <version>2.1.0</version>
            <exclusions>
                <exclusion>
                    <groupId>org.mybatis</groupId>
                    <artifactId>mybatis</artifactId>
                </exclusion>
            </exclusions>
        </dependency>

原因及建议

原因：
pageHeper本身集成了mybatis，不能同时引入mybatis-plus和mybatis，把pageHeper中的mybatis依赖排除后即可。
建议：
建议使用mybatisplus官方提供的分页插件，只需简单配置一步即可使用，非常方便。

使用MyBatisPlus官方提供的分页插件

3.5.9及之后的版本都需要单独引入依赖包，插件版本需要和你使用的mybatisplus版本一致

        <!-- mybatis-plus分页插件 -->
        <dependency>
            <groupId>com.baomidou</groupId>
            <artifactId>mybatis-plus-jsqlparser</artifactId>
            <version>3.5.10.1</version>
        </dependency>

配置

@Configuration
public class MyBatisPlusConfig {

    /**
     * 添加分页插件
     */
    @Bean
    public MybatisPlusInterceptor mybatisPlusInterceptor() {
        MybatisPlusInterceptor interceptor = new MybatisPlusInterceptor();
        // 如果配置多个插件, 切记分页最后添加
        interceptor.addInnerInterceptor(new PaginationInnerInterceptor(DbType.MYSQL));
        // 如果有多数据源可以不配具体类型, 否则都建议配上具体的 DbType
        return interceptor;
    }
}

使用

@Service
public class SupplierWarehouseServiceImpl extends ServiceImpl<SupplierWarehouseMapper, SupplierWarehouse> implements ISupplierWarehouseService {

    @Resource
    private SupplierWarehouseMapper supplierWarehouseMapper;

    @Override
    public IPage<SupplierWarehouse> pageQuery(Map<String, Object> params) {
        Integer current = (Integer) params.getOrDefault("pageNum", 1);
        Integer size = (Integer) params.getOrDefault("pageSize", 10);
        params.remove("pageSize");
        params.remove("pageNum");
        IPage<SupplierWarehouse> page = new Page<>(current, size);
        QueryWrapper<SupplierWarehouse> queryWrapper = new QueryWrapper<>();
        QueryWrapperUtil.builderQueryWrapper(queryWrapper, params, SupplierWarehouse.class);
        return supplierWarehouseMapper.selectPage(page, queryWrapper);
    }
}