. ____ _ __ _ _
/\\ / ___'_ __ _ _(_)_ __ __ _ \ \ \ \
( ( )\___ | '_ | '_| | '_ \/ _` | \ \ \ \
\\/ ___)| |_)| | | | | || (_| | ) ) ) )
' |____| .__|_| |_|_| |_\__, | / / / /
=========|_|==============|___/=/_/_/_/
:: Spring Boot :: (v1.5.4.RELEASE)
2.7.2为2.x的最后一个稳定版本。
. ____ _ __ _ _
/\\ / ___'_ __ _ _(_)_ __ __ _ \ \ \ \
( ( )\___ | '_ | '_| | '_ \/ _` | \ \ \ \
\\/ ___)| |_)| | | | | || (_| | ) ) ) )
' |____| .__|_| |_|_| |_\__, | / / / /
=========|_|==============|___/=/_/_/_/
:: Spring Boot :: (v2.7.2)
3开始最低要求 Java 17,所以暂时不到3.x。
以下的处理方法主要针对我们的项目,可能并不通用。
编译不报错,启动报错,在springboot1.3版本中会默认提供一个RestTemplate的实例Bean,当在springboot1.4以及以后的版本中,需要手动创建一个RestTemplate的配置,这里将会导致循环依赖
2022-09-28 13:13:43 [WARN] org.springframework.context.support.AbstractApplicationContext:591 : Exception encountered during context initialization - cancelling refresh attempt: org.springframework.beans.factory.UnsatisfiedDependencyException: Error creating bean with name 'fileDownloadServiceImpl': Unsatisfied dependency expressed through field 'restTemplate'; nested exception is org.springframework.beans.factory.NoSuchBeanDefinitionException: No qualifying bean of type 'org.springframework.web.client.RestTemplate' available: expected at least 1 bean which qualifies as autowire candidate. Dependency annotations: {@org.springframework.beans.factory.annotation.Autowired(required=true)}
2022-09-28 13:13:43 [INFO] org.apache.juli.logging.DirectJDKLog:173 : Stopping service [Tomcat]
2022-09-28 13:13:43 [INFO] org.springframework.boot.autoconfigure.logging.ConditionEvaluationReportLoggingListener:136 :
Error starting ApplicationContext. To display the conditions report re-run your application with 'debug' enabled.
2022-09-28 13:13:43 [ERROR] org.springframework.boot.diagnostics.LoggingFailureAnalysisReporter:40 :
***************************
APPLICATION FAILED TO START
***************************
Description:
Field restTemplate in com.service.impl.FileDownloadServiceImpl required a bean of type 'org.springframework.web.client.RestTemplate' that could not be found.
The injection point has the following annotations:
- @org.springframework.beans.factory.annotation.Autowired(required=true)
Action:
Consider defining a bean of type 'org.springframework.web.client.RestTemplate' in your configuration.
Process finished with exit code 1
修改方式: @Lazy注解
Springboot从2.3以后,spring-boot-starter-web中不再引入hibernate-validator,需要手动引入。
在父pom中引入,已经加入software-center-modules模块中,子模块不需要加:
<dependency>
<groupId>org.hibernate.validator</groupId>
<artifactId>hibernate-validator</artifactId>
<version>6.0.18.Final</version>
<scope>compile</scope>
</dependency>
去掉该方法
org.apache.logging.log4j.LoggingException: log4j-slf4j-impl cannot be present with log4j-to-slf4j
at org.apache.logging.slf4j.Log4jLoggerFactory.validateContext(Log4jLoggerFactory.java:60)
at org.apache.logging.slf4j.Log4jLoggerFactory.newLogger(Log4jLoggerFactory.java:44)
at org.apache.logging.slf4j.Log4jLoggerFactory.newLogger(Log4jLoggerFactory.java:33)
at org.apache.logging.log4j.spi.AbstractLoggerAdapter.getLogger(AbstractLoggerAdapter.java:53)
at org.apache.logging.slf4j.Log4jLoggerFactory.getLogger(Log4jLoggerFactory.java:33)
at org.slf4j.LoggerFactory.getLogger(LoggerFactory.java:363)
at org.slf4j.LoggerFactory.getLogger(LoggerFactory.java:388)
at com.ld.CreditTaskManageApplication.<clinit>(CreditTaskManageApplication.java:40)
... 34 more
排除掉springboot的logging
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-batch</artifactId>
<exclusions>
<!-- spring boot 默认的日志框架是Logback,所以在引用log4j之前,需要先排除该包的依赖,再引入log4j2的依赖 -->
<exclusion>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-logging</artifactId>
</exclusion>
</exclusions>
</dependency>
[credit-task-manage]2022-08-04 13:54:43.411 [WARN]:Exception encountered during context initialization - cancelling refresh attempt: org.springframework.context.ApplicationContextException: Unable to start web server; nested exception is org.springframework.beans.factory.UnsatisfiedDependencyException: Error creating bean with name 'webMainConfig': Unsatisfied dependency expressed through field 'handlerAdapter'; nested exception is org.springframework.beans.factory.UnsatisfiedDependencyException: Error creating bean with name 'org.springframework.boot.autoconfigure.web.servlet.WebMvcAutoConfiguration$EnableWebMvcConfiguration': Unsatisfied dependency expressed through method 'setConfigurers' parameter 0; nested exception is org.springframework.beans.factory.BeanCurrentlyInCreationException: Error creating bean with name 'webMainConfig': Requested bean is currently in creation: Is there an unresolvable circular reference? org.springframework.context.support.AbstractApplicationContext.refresh(AbstractApplicationContext.java:591)
The dependencies of some of the beans in the application context form a cycle:
┌─────┐
| webMainConfig (field private org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter com.ld.common.config.WebMainConfig.handlerAdapter)
↑ ↓
| org.springframework.boot.autoconfigure.web.servlet.WebMvcAutoConfiguration$EnableWebMvcConfiguration
└─────┘
Action:
Relying upon circular references is discouraged and they are prohibited by default. Update your application to remove the dependency cycle between beans. As a last resort, it may be possible to break the cycle automatically by setting spring.main.allow-circular-references to true.
org.springframework.boot.diagnostics.LoggingFailureAnalysisReporter.report(LoggingFailureAnalysisReporter.java:40)
WebMainConfig类中 去掉报错的方法和属性handlerAdapter,修改写法
@Bean
public ConversionService getConversionService(DateConverter dateConverter) {
ConversionServiceFactoryBean factoryBean = new ConversionServiceFactoryBean();
Set<Converter<String, Date>> converters = new HashSet<>();
converters.add(dateConverter);
factoryBean.setConverters(converters);
return factoryBean.getObject();
}
日期转换器,依赖hutool的日期工具类处理,如不满足再自行扩展
import java.util.Date;
import org.springframework.context.annotation.Configuration;
import org.springframework.core.convert.converter.Converter;
import cn.hutool.core.date.DateUtil;
/
* @Description 表单形式的全局时间类型转换器
*/
@Configuration
public class DateConverter implements Converter<String, Date> {
// 可以根据前端传递的时间格式自动匹配格式化
@Override
public Date convert(String source) {
return DateUtil.parse(source);
}
}
代码中应该尽量避免循环依赖的情况,如果出现了,在循环引用的属性上加@Lazy
注解,懒加载。
代码中不鼓励依赖循环引用,默认情况下禁止使用循环引用。如果能消除bean之间的依赖循环最好消除,如果实在改动太大,还有一种不推荐的处理方法,设置 spring.main.allow-circular-references=true
Application run failed org.springframework.boot.SpringApplication.reportFailure(SpringApplication.java:824)
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) ~[spring-context-5.3.22.jar:5.3.22]
启动报了“Failed to start bean ‘documentationPluginsBootstrapper’”,再往下面看到“springfox.documentation.spring.web.plugins.WebMvcRequestHandlerProvider”就可以断定是跟Swagger相关的问题。
查资料发现是新版本Spring Boot将Spring MVC默认路径匹配策略由AntPathMatcher更改为PathPatternParser,因此我们可以通过配置让其仍使用AntPathMatcher即可。
解决方案: 在application.properties里配置:
# 路径匹配策略使用旧版本的
spring.mvc.pathmatch.matching-strategy= ANT_PATH_MATCHER
顺便升级swagger到swagger3,已经加到base公共包里了
5.1、修改后路径需要修改,默认首页由swagger-ui.html变成了
/swagger-ui/index.html
5.2、如果还想使用扩展的2个ui的版本也需要跟着升级
<swagger-ui-layer.version>1.1.3</swagger-ui-layer.version>
<swagger-bootstrap-ui.version>1.9.6</swagger-bootstrap-ui.version>
我这里直接删除了那2个ui使用了swagger-bootstrap-ui的升级版:knife4j。base模块中已经引入
<knife4j.version>3.0.3</knife4j.version>
……
<dependency>
<groupId>com.github.xiaoymin</groupId>
<artifactId>knife4j-spring-boot-starter</artifactId>
<version>${knife4j.version}</version>
</dependency>
5.3、swagger的配置类,注解@EnableSwagger2去掉,名字改为更通用的SwaggerConfig
@Configuration
//@EnableSwagger2
@Slf4j
public class SwaggerConfig {
}
5.4、删除项目中自定义的pringfox.documentation.spring.web.readers包
5.5、去掉自定义的页面,如果想修改找到新的jar包复制出页面进行调整,否则可能看到的页面里没有内容
src/main/resources/META-INF/resources/doc.html
5.6 调整过滤器路径配置
#============================ 安全访问配置(SecurityFilter)========================
# 需要过滤的urlPatterns,多个用^分隔,没有或为空则不限制
security.access.urlPatterns = /doc.html^/docs.html^/swagger-ui.html^/swagger-ui/index.html^/v2/api-docs^/swagger-resources
如果出现跳转时出错:
Cannot forward to error page for request [/a/] as the response has already been committed. As a result, the response may have the wrong status code. If your application is running on WebSphere Application Server you may be able to resolve this problem by setting com.ibm.ws.webcontainer.invokeFlushAfterService to false org.springframework.boot.web.servlet.support.ErrorPageFilter.handleCommittedResponse(ErrorPageFilter.java:219)
解决方案同5
升级后发现java中是Date类型,数据库中datetime类型(Timestamp类型没有问题)的数据不是转换为Timestamp,而是直接转为LocalDateTime类型了,解决办法:com.ld.shieldsb.dao.MyBeanProcessor修改type2Bean方法,增加LocalDateTime和LocalDate的处理
if (value != null && fieldType.equals(Date.class)) {
if (value.getClass().equals(String.class)) {
SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
try {
field.set(model, sdf.parse((String) value));
} catch (ParseException e) {
log.error("日期字段读取失败," + fieldType + ",error:" + e.getMessage());
}
} else if (value.getClass().equals(LocalDateTime.class)) {
field.set(model, DateTimeUtil.localDateTime2Date((LocalDateTime) value));
} else if (value.getClass().equals(LocalDate.class)) {
field.set(model, DateTimeUtil.localDate2Date((LocalDate) value));
} else {
field.set(model, value);
}
}
我们使用的是mysql查看依赖jar包看到mysql-connector-java的版本从8.0.19变成了8.0.29
原因找到com.mysql.cj.jdbc.result.ResultSetImpl类的getObject(int columnIndex)方法可以看到Datetime类型的确实换了类型
case DATETIME:
return getTimestamp(columnIndex);
// 改为了
case DATETIME:
return getLocalDateTime(columnIndex);
Application run failed org.springframework.boot.SpringApplication.reportFailure(SpringApplication.java:824)
org.springframework.beans.factory.BeanCreationException: Error creating bean with name 'flywayInitializer' defined in class path resource [org/springframework/boot/autoconfigure/flyway/FlywayAutoConfiguration$FlywayConfiguration.class]: Invocation of init method failed; nested exception is org.flywaydb.core.api.FlywayException: Unsupported Database: MySQL 5.7
at org.springframework.beans.factory.support.AbstractAutowireCapableBeanFactory.initializeBean(AbstractAutowireCapableBeanFactory.java:1804) ~[spring-beans-5.3.22.jar:5.3.22]
……
at org.apache.catalina.startup.Bootstrap.start(Bootstrap.java:343) [bootstrap.jar:9.0.31]
at org.apache.catalina.startup.Bootstrap.main(Bootstrap.java:474) [bootstrap.jar:9.0.31]
Caused by: org.flywaydb.core.api.FlywayException: Unsupported Database: MySQL 5.7
at org.flywaydb.core.internal.database.DatabaseTypeRegister.getDatabaseTypeForConnection(DatabaseTypeRegister.java:106) ~[flyway-core-8.5.13.jar:?]
……org.springframework.beans.factory.support.AbstractAutowireCapableBeanFactory.initializeBean(AbstractAutowireCapableBeanFactory.java:1800) ~[spring-beans-5.3.22.jar:5.3.22]
... 49 more
flyway对数据库版本有要求,例如flyway-core的当前版本V8.4.3,不能使用 MySQL 5.7, 当flyway-core 降低到V7.15.0后 问题解决,所以匹配flyway-core和数据库版本后问题即可解决。
<properties>
……
<flyway.version>7.15.0</flyway.version>
</properties>
……
<!-- 添加 flyway 的依赖,flyway需要区分版本,不同版本对不同数据库版本支持不同 -->
<dependency>
<groupId>org.flywaydb</groupId>
<artifactId>flyway-core</artifactId>
<version>${flyway.version}</version>
</dependency>
……
升级后默认使用junit5,而依赖的jar包中引入了junit4的jar包冲突了,去掉junit4的jar包即可。
注意使用junit5后包的名字发生了变化,下面箭头前后分别是junit4和junit5的
org.junit.Test》org.junit.jupiter.api.Test
org.junit.runner.RunWith》org.junit.jupiter.api.extension.ExtendWith
//使用时
@RunWith(SpringRunner.class)》@ExtendWith(SpringExtension.class)
出现如下情况,前面是真实值后面为json传递后的值
344280995828072448》344280995828072450
344268472663932928》344268472663932900
343301120241696768》343301120241696800
原项目中是有Long转字符串的处理的。
问题原因:经查看,默认已经有多个消息转换器了。而 configureMessageConverters 方法中是一个 list 参数。直接向其中添加 HttpMessageConverter 后,默认是排在最后的。就造成了你自定义的消息转换器不生效。其实是被其他转换器接管了。
解决办法:加到第一个就行了。add(0, customConverter())
@Override
public void configureMessageConverters(List<HttpMessageConverter<?>> converters) {
FastJsonHttpMessageConverter fastConverter = new FastJsonHttpMessageConverter();
……
// 支持text 转string
converters.add(0, customJackson2HttpMessageConverter());
converters.add(0, new StringHttpMessageConverter(StandardCharsets.UTF_8));
converters.add(0, fastConverter);
}
如果使用的是@bean注解,覆盖的fastjson则不需要改,如下:
@Bean
public HttpMessageConverters customConverters() {
FastJsonHttpMessageConverter fastConverter = new FastJsonHttpMessageConverter();
// 创建配置类
FastJsonConfig fastJsonConfig = new FastJsonConfig();
fastJsonConfig.setSerializerFeatures(SerializerFeature.WriteNullListAsEmpty, SerializerFeature.WriteMapNullValue,
SerializerFeature.WriteNullStringAsEmpty);
// 解决 Long 转json 精度丢失的问题
SerializeConfig serializeConfig = SerializeConfig.globalInstance;
serializeConfig.put(BigInteger.class, ToStringSerializer.instance);
serializeConfig.put(Long.class, ToStringSerializer.instance);
serializeConfig.put(Long.TYPE, ToStringSerializer.instance);
fastJsonConfig.setSerializeConfig(serializeConfig);
// 此处是全局处理方式
fastJsonConfig.setDateFormat(DATE_FORMAT);
fastJsonConfig.setCharset(StandardCharsets.UTF_8);
fastConverter.setFastJsonConfig(fastJsonConfig);
List<MediaType> supportedMediaTypes = new ArrayList<>();
supportedMediaTypes.add(MediaType.APPLICATION_JSON);
fastConverter.setSupportedMediaTypes(supportedMediaTypes);
// 支持text 转string
StringHttpMessageConverter stringHttpMessageConverter = new StringHttpMessageConverter();
return new HttpMessageConverters(fastConverter, stringHttpMessageConverter);
}
从2.4开始配置文件的加载方式就变化了,以及很多不兼容的变化,而且springcloud alibaba也基本都是支持2.3 ,dubbo也是,因此除非有什么特殊目的,2.3就是目前的最终版本,要升级就等明年的3版本GA,那个时候一定有大量项目跟进, 其实我们用spring就是用ioc和aop,其他第三方依赖基本都是自己封装,比如redis,es,mongo,mq,用spring不仅性能低也依赖版本受限制,我唯一觉得不错的就是jdbctemplate以及resttemplate,这俩性能都非常不错,我司对这两个进行二次封装进行了简化开发并且保证性能不下降,因为方便开发一定会用到反射和动态代理,保证他俩性能不下降是一门功夫~
如果这篇文章对您有所帮助,或者有所启发的话,求一键三连:点赞、评论、收藏➕关注,您的支持是我坚持写作最大的动力。