springboot读取bootstrap配置及knife4j版本兼容性问题及解决
作者:荔枝hu
因某些特殊原因,需要使用springboot项目读取bootstrap.yml
中配置,然而添加bootstrap依赖包后,又引发了springboot、springcloud与knife4j版本匹配的问题 这真是一个环。。。
项目框架说明
项目背景说明:
- SpringBoot 2.2.5.RELEASE
- knife4j 3.0.3
连环坑
- 引入bootstrap启动前配置后,启动失败
- 按照错误升级springboot版本至2.6.6后,启动失败
- knife4j与springboot版本不兼容,需降springboot版本
- 尝试三者的版本匹配
问题一:springboot项目无法读取bootstrap.yml配置
出现此问题的原因:
SpringBoot项目,只会识别application. *配置文件,并不会自动识别bootstrap.yml
解决方案:
在pom.xml中添加了bootstrap启动器依赖
<dependency> <groupId>org.springframework.cloud</groupId> <artifactId>spring-cloud-starter-bootstrap</artifactId> <version>3.1.1</version> </dependency>
问题二:启动报错,springboot与springcloud版本不匹配
错误如下:
Spring Boot [2.2.5.RELEASE] is not compatible with this Spring Cloud release train
Action:
Consider applying the following actions:
- Change Spring Boot version to one of the following versions [2.6.x, 2.7.x] .
没办法,按照错误升级springboot版本吧(初步尝试2.6.6)
问题三:启动报错Failed to start bean‘documentationPluginsBootstrapper’
错误如下:
org.springframework.context.ApplicationContextException: Failed to start bean 'documentationPluginsBootstrapper'
在网上查找了下相关问题,参考文献:org.springframework.context.ApplicationContextException的解决办法,发现是knife4j(swagger)与springboot版本不匹配,得降低springboot版本!!!
另一种解决方案:
修改springmvc的路径匹配策略 - 待验证
因为Springfox使用的路径匹配是基于AntPathMatcher的,而Spring Boot 2.6.X使用的是PathPatternMatcher。
#解决:在application.properties里配置 spring.mvc.pathmatch.matching-strategy=ANT_PATH_MATCHER
版本匹配
springboot与bootstrap(springcloud)
bootstrap(springcloud)版本 | springboot版本 |
---|---|
3.0.1及3.0.0 | [2.3.x, 2.4.x] |
3.0.3 | [2.4.x, 2.5.x] |
3.1.1 | [2.6.x, 2.7.x] |
最终版本方案
SpringBoot 2.4.13 + SpringCloud 3.0.1 + knife4j 3.0.3 终于可以了!!!!
后记:不要轻易升级版本
泪的教训啊,想着knife4j升级一个大版本看下新特性,结果引发了一系列问题~
自己对于框架的知识还是不够清楚啊,得努力学习喽~
以上为个人经验,希望能给大家一个参考,也希望大家多多支持脚本之家。