本文主要记录本人使用 springboot 开发过程中碰到的问题,以及解决方案,此文将会不定期更新
1、pom 文件中依赖问题
问题:pom 文件如下报错,运行程序无影响,打包时报错
错误信息:
pom.xml: expected START_TAG or END_TAG not TEXT (position: TEXT seen …\n \ua0\ua0\ua0 等
<dependency>
<groupId>io.springfox</groupId>
<artifactId>springfox-swagger2</artifactId>
<version>2.9.2</version>
</dependency>
<dependency>
<groupId>com.github.xiaoymin</groupId>
<artifactId>swagger-bootstrap-ui</artifactId>
<version>1.9.2</version>
</dependency>
原因:依赖中存在缩进,警告提示区域存在空格等不规范字符,我们在网上复制到项目中时经常出现类似问题
解决:去掉缩进,错误消失,打包正常
<dependency>
<groupId>io.springfox</groupId>
<artifactId>springfox-swagger2</artifactId>
<version>2.9.2</version>
</dependency>
<dependency>
<groupId>com.github.xiaoymin</groupId>
<artifactId>swagger-bootstrap-ui</artifactId>
<version>1.9.2</version>
</dependency>
版本升级问题
1、springboot 2.1.6 升级到 2.3.4 版本
springboot 2.1.6 升级到 2.3.4 版本导致的文件上传失败问题
问题现象
springboot 升级之后,原本用的好好的文件上传咋就不行了呢,真让人头痛
报错信息
2020-11-17 09:58:08.187 ERROR 9152
--- [nio-9090-exec-9] o.a.c.c.C.[.[.[/].[dispatcherServlet] :
Servlet.service() for servlet [dispatcherServlet] in context with path []
threw exception [Request processing failed;
nested exception is org.springframework.web.multipart.MultipartException:
Failed to parse multipart servlet request; nested exception is
java.io.IOException: org.apache.tomcat.util.http.fileupload.
FileUploadException: Stream closed] with root cause
java.io.IOException: Stream closed
解决思路
看到这一堆错误信息之后,根据错误信息立马去百度查阅相关资料,结果可想而知,都不是我想要的答案
最后,突然想到,我昨天不是升级了 springboot 版本么,会不会是这个原因呢?
百度一看,果然,还是有很多像我一样的小伙伴的
解决方法
spring:
#解决 springboot 升版后文件上传问题
mvc:
hiddenmethod:
filter:
enabled: true
只需要在 application.yml 配置文件中,配置这段代码,重新启动服务即可
问题原因
原来的springboot 版本,我们使用了 logback-access 过滤器
过滤器用 httpServletRequest 缓存包装器包裹,并在沿着过滤器传递请求之前关闭了输入流,然后在 javax.servlet.http.HttpServletRequest#getParts 调用时引起了问题,因为该调用被委托给原始 Tomcat 的请求(具有现在关闭的输入流)然后导致 “流关闭” 异常
引发此问题的根本原因是 spring 改变了 hiddenHttpMethodFilter 的过滤机制,使 hiddenHttpMethodFilter 不再存在于过滤器链中,在没有升级之前,这个过滤器是第一个被调用的过滤器,它会调用 HttpServletRequest#getParameter,这将使 Tomcat 的请求实现解析多部分内容并将这些部分存储再对象中(以便以后的调用 #getParts 将使用它而不尝试再次进行解析)
我们在配置文件中配置的内容会使得
HttpServletRequest#getParameter 再将请求传递到 logback 的过滤器之前进行调用(相关代码可以查看 LOGBACK-1503),以强制 Tomcat 在输入流仍然处于打开状态时解析和存储请求部分
总结
简单来说就是 springboot 2.0 以上默认关闭了这个方法,导致这个过滤器没有发生作用,所以就关闭了,无法解析和存储我们的部分请求
2、SpringBoot 2.6.X
问题现象
Failed to start bean ‘documentationPluginsBootstrapper’; nested exception is java.lang.NullPointerException
org.springframework.context.ApplicationContextException: Failed to start bean 'documentationPluginsBootstrapper'; nested exception is java.lang.NullPointerException
at org.springframework.context.support.DefaultLifecycleProcessor.doStart(DefaultLifecycleProcessor.java:181)
at org.springframework.context.support.DefaultLifecycleProcessor.access$200(DefaultLifecycleProcessor.java:54)
at org.springframework.context.support.DefaultLifecycleProcessor$LifecycleGroup.start(DefaultLifecycleProcessor.java:356)
at java.base/java.lang.Iterable.forEach(Iterable.java:75)
at org.springframework.context.support.DefaultLifecycleProcessor.startBeans(DefaultLifecycleProcessor.java:155)
at org.springframework.context.support.DefaultLifecycleProcessor.onRefresh(DefaultLifecycleProcessor.java:123)
at org.springframework.context.support.AbstractApplicationContext.finishRefresh(AbstractApplicationContext.java:935)
at org.springframework.context.support.AbstractApplicationContext.refresh(AbstractApplicationContext.java:586)
at org.springframework.boot.web.servlet.context.ServletWebServerApplicationContext.refresh(ServletWebServerApplicationContext.java:145)
at org.springframework.boot.SpringApplication.refresh(SpringApplication.java:745)
at org.springframework.boot.SpringApplication.refreshContext(SpringApplication.java:420)
at org.springframework.boot.SpringApplication.run(SpringApplication.java:307)
at org.springframework.boot.SpringApplication.run(SpringApplication.java:1317)
at org.springframework.boot.SpringApplication.run(SpringApplication.java:1306)
at com.wxw.note.Application.main(Application.java:19)
Caused by: java.lang.NullPointerException: null
at springfox.documentation.spring.web.WebMvcPatternsRequestConditionWrapper.getPatterns(WebMvcPatternsRequestConditionWrapper.java:56)
at springfox.documentation.RequestHandler.sortedPaths(RequestHandler.java:112)
at springfox.documentation.spi.service.contexts.Orderings.lambda$byPatternsCondition$3(Orderings.java:89)
at java.base/java.util.Comparator.lambda$comparing$77a9974f$1(Comparator.java:469)
at java.base/java.util.TimSort.countRunAndMakeAscending(TimSort.java:355)
at java.base/java.util.TimSort.sort(TimSort.java:220)
at java.base/java.util.Arrays.sort(Arrays.java:1515)
at java.base/java.util.ArrayList.sort(ArrayList.java:1749)
at java.base/java.util.stream.SortedOps$RefSortingSink.end(SortedOps.java:392)
at java.base/java.util.stream.Sink$ChainedReference.end(Sink.java:258)
at java.base/java.util.stream.Sink$ChainedReference.end(Sink.java:258)
at java.base/java.util.stream.Sink$ChainedReference.end(Sink.java:258)
at java.base/java.util.stream.Sink$ChainedReference.end(Sink.java:258)
at java.base/java.util.stream.AbstractPipeline.copyInto(AbstractPipeline.java:485)
at java.base/java.util.stream.AbstractPipeline.wrapAndCopyInto(AbstractPipeline.java:474)
at java.base/java.util.stream.ReduceOps$ReduceOp.evaluateSequential(ReduceOps.java:913)
at java.base/java.util.stream.AbstractPipeline.evaluate(AbstractPipeline.java:234)
at java.base/java.util.stream.ReferencePipeline.collect(ReferencePipeline.java:578)
at springfox.documentation.spring.web.plugins.WebMvcRequestHandlerProvider.requestHandlers(WebMvcRequestHandlerProvider.java:76)
at java.base/java.util.stream.ReferencePipeline$3$1.accept(ReferencePipeline.java:195)
at java.base/java.util.ArrayList$ArrayListSpliterator.forEachRemaining(ArrayList.java:1654)
at java.base/java.util.stream.AbstractPipeline.copyInto(AbstractPipeline.java:484)
at java.base/java.util.stream.AbstractPipeline.wrapAndCopyInto(AbstractPipeline.java:474)
at java.base/java.util.stream.ReduceOps$ReduceOp.evaluateSequential(ReduceOps.java:913)
at java.base/java.util.stream.AbstractPipeline.evaluate(AbstractPipeline.java:234)
at java.base/java.util.stream.ReferencePipeline.collect(ReferencePipeline.java:578)
at springfox.documentation.spring.web.plugins.AbstractDocumentationPluginsBootstrapper.defaultContextBuilder(AbstractDocumentationPluginsBootstrapper.java:108)
at springfox.documentation.spring.web.plugins.AbstractDocumentationPluginsBootstrapper.buildContext(AbstractDocumentationPluginsBootstrapper.java:92)
at springfox.documentation.spring.web.plugins.AbstractDocumentationPluginsBootstrapper.bootstrapDocumentationPlugins(AbstractDocumentationPluginsBootstrapper.java:83)
at springfox.documentation.spring.web.plugins.DocumentationPluginsBootstrapper.start(DocumentationPluginsBootstrapper.java:94)
at org.springframework.context.support.DefaultLifecycleProcessor.doStart(DefaultLifecycleProcessor.java:178)
... 14 common frames omitted
解决方案一
application.yml 增加配置
spring:
mvc:
pathmatch:
matching-strategy: ant_path_matcher
解决方案二
增加注解
@EnableWebMvc