zoukankan      html  css  js  c++  java

  • SpringBoot集成PageHelper时出现“在系统中发现了多个分页插件,请检查系统配置!”

    近日在项目中使用SpringBoot集成PageHelper后，跑单元测试时出现了“在系统中发现了多个分页插件,请检查系统配置!”这个问题。

    如下图所示：

    1. org.mybatis.spring.MyBatisSystemException: nested exception is org.apache.ibatis.exceptions.PersistenceException: 
    2. ### Error querying database.  Cause: java.lang.RuntimeException: 在系统中发现了多个分页插件，请检查系统配置!
    3. ### Cause: java.lang.RuntimeException: 在系统中发现了多个分页插件，请检查系统配置!
    4.  
    5. 	at org.mybatis.spring.MyBatisExceptionTranslator.translateExceptionIfPossible(MyBatisExceptionTranslator.java:77)
    6. 	at org.mybatis.spring.SqlSessionTemplate$SqlSessionInterceptor.invoke(SqlSessionTemplate.java:446)
    7. 	at com.sun.proxy.$Proxy109.selectList(Unknown Source)
    8. 	at org.mybatis.spring.SqlSessionTemplate.selectList(SqlSessionTemplate.java:230)
    9. 	at org.apache.ibatis.binding.MapperMethod.executeForMany(MapperMethod.java:137)
    10. 	at org.apache.ibatis.binding.MapperMethod.execute(MapperMethod.java:75)
    11. 	at org.apache.ibatis.binding.MapperProxy.invoke(MapperProxy.java:59)
    12. 	at com.sun.proxy.$Proxy110.selectAll(Unknown Source)
    13. 	at com.lianjia.cto.ke.broadband.service.StationInfoService.selectPage(StationInfoService.java:27)
    14. 	at com.lianjia.cto.ke.broadband.service.StationInfoService$$FastClassBySpringCGLIB$$ee2f34a4.invoke(<generated>)
    15. 	at org.springframework.cglib.proxy.MethodProxy.invoke(MethodProxy.java:204)
    16. 	at org.springframework.aop.framework.CglibAopProxy$CglibMethodInvocation.invokeJoinpoint(CglibAopProxy.java:738)
    17. 	at org.springframework.aop.framework.ReflectiveMethodInvocation.proceed(ReflectiveMethodInvocation.java:157)
    18. 	at org.springframework.aop.framework.adapter.MethodBeforeAdviceInterceptor.invoke(MethodBeforeAdviceInterceptor.java:52)
    19. 	at org.springframework.aop.framework.ReflectiveMethodInvocation.proceed(ReflectiveMethodInvocation.java:168)
    20. 	at org.springframework.aop.interceptor.ExposeInvocationInterceptor.invoke(ExposeInvocationInterceptor.java:92)
    21. 	at org.springframework.aop.framework.ReflectiveMethodInvocation.proceed(ReflectiveMethodInvocation.java:179)
    22. 	at org.springframework.aop.framework.CglibAopProxy$DynamicAdvisedInterceptor.intercept(CglibAopProxy.java:673)
    23. 	at com.lianjia.cto.ke.broadband.service.StationInfoService$$EnhancerBySpringCGLIB$$1da3a0f3.selectPage(<generated>)
    24. 	at com.lianjia.cto.ke.broadband.service.StationInfoServiceTest.selectPage(StationInfoServiceTest.java:27)
    25. 	at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
    26. 	at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:62)
    27. 	at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43)
    28. 	at java.lang.reflect.Method.invoke(Method.java:498)
    29. 	at org.junit.runners.model.FrameworkMethod$1.runReflectiveCall(FrameworkMethod.java:50)
    30. 	at org.junit.internal.runners.model.ReflectiveCallable.run(ReflectiveCallable.java:12)
    31. 	at org.junit.runners.model.FrameworkMethod.invokeExplosively(FrameworkMethod.java:47)
    32. 	at org.junit.internal.runners.statements.InvokeMethod.evaluate(InvokeMethod.java:17)
    33. 	at org.springframework.test.context.junit4.statements.RunBeforeTestMethodCallbacks.evaluate(RunBeforeTestMethodCallbacks.java:75)
    34. 	at org.springframework.test.context.junit4.statements.RunAfterTestMethodCallbacks.evaluate(RunAfterTestMethodCallbacks.java:86)
    35. 	at org.springframework.test.context.junit4.statements.SpringRepeat.evaluate(SpringRepeat.java:84)
    36. 	at org.junit.runners.ParentRunner.runLeaf(ParentRunner.java:325)
    37. 	at org.springframework.test.context.junit4.SpringJUnit4ClassRunner.runChild(SpringJUnit4ClassRunner.java:252)
    38. 	at org.springframework.test.context.junit4.SpringJUnit4ClassRunner.runChild(SpringJUnit4ClassRunner.java:94)
    39. 	at org.junit.runners.ParentRunner$3.run(ParentRunner.java:290)
    40. 	at org.junit.runners.ParentRunner$1.schedule(ParentRunner.java:71)
    41. 	at org.junit.runners.ParentRunner.runChildren(ParentRunner.java:288)
    42. 	at org.junit.runners.ParentRunner.access$000(ParentRunner.java:58)
    43. 	at org.junit.runners.ParentRunner$2.evaluate(ParentRunner.java:268)
    44. 	at org.springframework.test.context.junit4.statements.RunBeforeTestClassCallbacks.evaluate(RunBeforeTestClassCallbacks.java:61)
    45. 	at org.springframework.test.context.junit4.statements.RunAfterTestClassCallbacks.evaluate(RunAfterTestClassCallbacks.java:70)
    46. 	at org.junit.runners.ParentRunner.run(ParentRunner.java:363)
    47. 	at org.springframework.test.context.junit4.SpringJUnit4ClassRunner.run(SpringJUnit4ClassRunner.java:191)
    48. 	at org.junit.runner.JUnitCore.run(JUnitCore.java:137)
    49. 	at com.intellij.junit4.JUnit4IdeaTestRunner.startRunnerWithArgs(JUnit4IdeaTestRunner.java:68)
    50. 	at com.intellij.rt.execution.junit.IdeaTestRunner$Repeater.startRunnerWithArgs(IdeaTestRunner.java:47)
    51. 	at com.intellij.rt.execution.junit.JUnitStarter.prepareStreamsAndStart(JUnitStarter.java:242)
    52. 	at com.intellij.rt.execution.junit.JUnitStarter.main(JUnitStarter.java:70)
    53. Caused by: org.apache.ibatis.exceptions.PersistenceException: 
    54. ### Error querying database.  Cause: java.lang.RuntimeException: 在系统中发现了多个分页插件，请检查系统配置!
    55. ### Cause: java.lang.RuntimeException: 在系统中发现了多个分页插件，请检查系统配置!
    56. 	at org.apache.ibatis.exceptions.ExceptionFactory.wrapException(ExceptionFactory.java:30)
    57. 	at org.apache.ibatis.session.defaults.DefaultSqlSession.selectList(DefaultSqlSession.java:150)
    58. 	at org.apache.ibatis.session.defaults.DefaultSqlSession.selectList(DefaultSqlSession.java:141)
    59. 	at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
    60. 	at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:62)
    61. 	at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43)
    62. 	at java.lang.reflect.Method.invoke(Method.java:498)
    63. 	at org.mybatis.spring.SqlSessionTemplate$SqlSessionInterceptor.invoke(SqlSessionTemplate.java:433)
    64. 	... 46 more
    65. Caused by: java.lang.RuntimeException: 在系统中发现了多个分页插件，请检查系统配置!
    66. 	at com.github.pagehelper.PageHelper.skip(PageHelper.java:55)
    67. 	at com.github.pagehelper.PageInterceptor.intercept(PageInterceptor.java:92)
    68. 	at org.apache.ibatis.plugin.Plugin.invoke(Plugin.java:61)
    69. 	at com.sun.proxy.$Proxy123.query(Unknown Source)
    70. 	at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
    71. 	at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:62)
    72. 	at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43)
    73. 	at java.lang.reflect.Method.invoke(Method.java:498)
    74. 	at org.apache.ibatis.plugin.Plugin.invoke(Plugin.java:63)
    75. 	at com.sun.proxy.$Proxy123.query(Unknown Source)
    76. 	at com.github.pagehelper.PageInterceptor.executeAutoCount(PageInterceptor.java:201)
    77. 	at com.github.pagehelper.PageInterceptor.intercept(PageInterceptor.java:113)
    78. 	at org.apache.ibatis.plugin.Plugin.invoke(Plugin.java:61)
    79. 	at com.sun.proxy.$Proxy123.query(Unknown Source)
    80. 	at org.apache.ibatis.session.defaults.DefaultSqlSession.selectList(DefaultSqlSession.java:148)
    81. 	... 52 more

    先上结果：maven的pagehelper-spring-boot-starter这个依赖，提供了自动配置分页插件的功能，所以有两种方法解决这个问题

    第一种，SpringBoot启动类的注解上排除这个自动配置

    @SpringBootApplication(exclude = PageHelperAutoConfiguration.class)

    第二种，在构建SqlSessionFactory时，不要再去手动添加分页的拦截器，在application.yml中进行配置pagehelper的属性，在SpringBoot启动时会将配置自动注入生成拦截器

    1. # PageHelper配置
    2. pagehelper:
    3.      offsetAsPageNum: true
    4.      rowBoundsWithCount: true
    5.      reasonable: true
    6.      returnPageInfo: true
    7.      params: count=countSql

    以下是解决问题的思路：

    看到这个报错后，查看了一下配置，发现并没有配置多个PageHelper。于是查看了一下报错部分的源码，问题出现在一个skip方法中，如下图所示：

    1. public class PageHelper extends PageMethod implements Dialect {
    2.      //...
    3.  
    4.     @Override
    5.     public boolean skip(MappedStatement ms, Object parameterObject, RowBounds rowBounds) {
    6.         //此处的MSUtils.COUNT为一个常量值"_COUNT"
    7.         if(ms.getId().endsWith(MSUtils.COUNT)){
    8.             throw new RuntimeException("在系统中发现了多个分页插件，请检查系统配置!");
    9.         }
    10.        //...
    11.     }
    12.  
    13.     //...
    14. }

    继续向上找，找到了分页插件的拦截器

    1. public class PageInterceptor implements Interceptor {
    2.     //...
    3.     private String countSuffix = "_COUNT";
    4.  
    5.     @Override
    6.     public Object intercept(Invocation invocation) throws Throwable {
    7.         try {
    8.             //...
    9.  
    10.             //调用方法判断是否需要进行分页，如果不需要，直接返回结果
    11.             if (!dialect.skip(ms, parameter, rowBounds)) {
    12.                 //反射获取动态参数
    13.                 String msId = ms.getId();
    14.                 Configuration configuration = ms.getConfiguration();
    15.                 Map<String, Object> additionalParameters = (Map<String, Object>) additionalParametersField.get(boundSql);
    16.                 //判断是否需要进行 count 查询
    17.                 if (dialect.beforeCount(ms, parameter, rowBounds)) {
    18.                     String countMsId = msId + countSuffix;
    19.                     Long count;
    20.                     //先判断是否存在手写的 count 查询
    21.                     MappedStatement countMs = getExistedMappedStatement(configuration, countMsId);
    22.                     if(countMs != null){
    23.                         count = executeManualCount(executor, countMs, parameter, boundSql, resultHandler);
    24.                     } else {
    25.                         countMs = msCountMap.get(countMsId);
    26.                         //自动创建
    27.                         if (countMs == null) {
    28.                             //根据当前的 ms 创建一个返回值为 Long 类型的 ms
    29.                             countMs = MSUtils.newCountMappedStatement(ms, countMsId);
    30.                             msCountMap.put(countMsId, countMs);
    31.                         }
    32.                         count = executeAutoCount(executor, countMs, parameter, boundSql, rowBounds, resultHandler);
    33.                     }
    34.                     //处理查询总数
    35.                     //返回 true 时继续分页查询，false 时直接返回
    36.                     if (!dialect.afterCount(count, parameter, rowBounds)) {
    37.                         //当查询总数为 0 时，直接返回空的结果
    38.                         return dialect.afterPage(new ArrayList(), parameter, rowBounds);
    39.                     }
    40.                 }
    41.                 //判断是否需要进行分页查询
    42.                 if (dialect.beforePage(ms, parameter, rowBounds)) {
    43.                     //生成分页的缓存 key
    44.                     CacheKey pageKey = cacheKey;
    45.                     //处理参数对象
    46.                     parameter = dialect.processParameterObject(ms, parameter, boundSql, pageKey);
    47.                     //调用方言获取分页 sql
    48.                     String pageSql = dialect.getPageSql(ms, boundSql, parameter, rowBounds, pageKey);
    49.                     BoundSql pageBoundSql = new BoundSql(configuration, pageSql, boundSql.getParameterMappings(), parameter);
    50.                     //设置动态参数
    51.                     for (String key : additionalParameters.keySet()) {
    52.                         pageBoundSql.setAdditionalParameter(key, additionalParameters.get(key));
    53.                     }
    54.                     //执行分页查询
    55.                     resultList = executor.query(ms, parameter, RowBounds.DEFAULT, resultHandler, pageKey, pageBoundSql);
    56.                 } else {
    57.                     //不执行分页的情况下，也不执行内存分页
    58.                     resultList = executor.query(ms, parameter, RowBounds.DEFAULT, resultHandler, cacheKey, boundSql);
    59.                 }
    60.             } else {
    61.                 //rowBounds用参数值，不使用分页插件处理时，仍然支持默认的内存分页
    62.                 resultList = executor.query(ms, parameter, rowBounds, resultHandler, cacheKey, boundSql);
    63.             }
    64.             return dialect.afterPage(resultList, parameter, rowBounds);
    65.         } finally {
    66.             dialect.afterAll();
    67.         }
    68.     }
    69. }

    可以发现以_COUNT结尾的MappedStatement.id是由分页插件的拦截器自动生成的，而这个由分页插件的生成之后，怎么会又一次的调用skip方法呢？所以猜测是有多个分页插件的拦截器影响到了。于是查阅了一下相关的资料，发现PageHelper引入了SpringBoot的自动配置，以下是自动配置的源码：

    1. @Configuration
    2. @ConditionalOnBean(SqlSessionFactory.class)
    3. @EnableConfigurationProperties(PageHelperProperties.class)
    4. @AutoConfigureAfter(MybatisAutoConfiguration.class)
    5. public class PageHelperAutoConfiguration {
    6.  
    7.     @Autowired
    8.     private List<SqlSessionFactory> sqlSessionFactoryList;
    9.  
    10.     @Autowired
    11.     private PageHelperProperties properties;
    12.  
    13.     /**
    14.      * 接受分页插件额外的属性
    15.      *
    16.      * @return
    17.      */
    18.     @Bean
    19.     @ConfigurationProperties(prefix = PageHelperProperties.PAGEHELPER_PREFIX)
    20.     public Properties pageHelperProperties() {
    21.         return new Properties();
    22.     }
    23.  
    24.     @PostConstruct
    25.     public void addPageInterceptor() {
    26.         PageInterceptor interceptor = new PageInterceptor();
    27.         Properties properties = new Properties();
    28.         //先把一般方式配置的属性放进去
    29.         properties.putAll(pageHelperProperties());
    30.         //在把特殊配置放进去，由于close-conn 利用上面方式时，属性名就是 close-conn 而不是 closeConn，所以需要额外的一步
    31.         properties.putAll(this.properties.getProperties());
    32.         interceptor.setProperties(properties);
    33.         for (SqlSessionFactory sqlSessionFactory : sqlSessionFactoryList) {
    34.             sqlSessionFactory.getConfiguration().addInterceptor(interceptor);
    35.         }
    36.     }
    37.  
    38. }

    至此，问题算是比较明白了，是因为多个分页拦截器的作用，导致了该异常的出现，所以全局只要保留一个就可以了。
  • 相关阅读:
    循环处理
    XMLHttpRequest 加载进度
    createjs 的 bitmapdata类
    console打印数组object具体内容
    html5 粒子组合成logo 的制作思路及方法
    createjs 更新
    css取消input、select默认样式（手机端）
    js获取url参数 兼容某些带#url
    Adobe Edge Animate CC 不再开发更新！
    《FLASH CC 2015 CANVAS 中文教程》——3、this关键字 入门
  • 原文地址：https://www.cnblogs.com/jpfss/p/9723828.html
Copyright © 2011-2022 走看看