Springboot 升级到2.7.0 踩过的坑

的版本信息

https://huaweicloud.csdn.net/63876b9bdacf622b8df8bacf.html

<parent>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-parent</artifactId>
    <version>2.7.0</version>
    <relativePath></relativePath> <!-- lookup parent from repository -->
</parent>
<spring-cloud.version>2021.0.3</spring-cloud.version>
<spring-cloud-alibaba.version>2021.0.1.0</spring-cloud-alibaba.version>

<!--Spring Cloud 相关依赖-->
<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-dependencies</artifactId>
    <version>${spring-cloud.version}</version>
    <type>pom</type>
    <scope>import</scope>
</dependency>
<!--Spring Cloud Alibaba 相关依赖-->
<dependency>
    <groupId>com.alibaba.cloud</groupId>
    <artifactId>spring-cloud-alibaba-dependencies</artifactId>
    <version>${spring-cloud-alibaba.version}</version>
    <type>pom</type>
    <scope>import</scope>
</dependency>

1. bootstrap.yaml 加载问题

高版本的springboot bootstrap.yaml 加载需要引入依赖

<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-bootstrap</artifactId>
    <version>3.1.3</version>
</dependency>

2. nacos 根据服务名称无法访问，负载均衡失效

高版本的springboot nacos 需要引入 loadbalancer 依赖

<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-loadbalancer</artifactId>
</dependency>
<dependency>
    <groupId>com.alibaba.cloud</groupId>
    <artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
</dependency>
<dependency>
    <groupId>com.alibaba.cloud</groupId>
    <artifactId>spring-cloud-starter-alibaba-nacos-config</artifactId>
</dependency>

3. swagger 报documentationPluginsBootstrapper null异常

高版本的springboot swagger 会报 documentationPluginsBootstrapper null异常 修改如下

/**
 * documentationPluginsBootstrapper null异常解决
 * 原因：Springfox 假设 Spring MVC 的路径匹配策略是 ant-path-matcher，而 Spring Boot 2.6.x版本的默认匹配策略是 path-pattern-matcher，这就造成了上面的报错
 */
@Bean
public static BeanPostProcessor springfoxHandlerProviderBeanPostProcessor() {
    return new BeanPostProcessor() {

        @Override
        public Object postProcessAfterInitialization(Object bean, String beanName) throws BeansException {
            if (bean instanceof WebMvcRequestHandlerProvider || bean instanceof WebFluxRequestHandlerProvider) {
                customizeSpringfoxHandlerMappings(getHandlerMappings(bean));
            }
            return bean;
        }

        private <T extends RequestMappingInfoHandlerMapping> void customizeSpringfoxHandlerMappings(List<T> mappings) {
            List<T> copy = mappings.stream()
                    .filter(mapping -> mapping.getPatternParser() == null)
                    .collect(Collectors.toList());
            mappings.clear();
            mappings.addAll(copy);
        }

        @SuppressWarnings("unchecked")
        private List<RequestMappingInfoHandlerMapping> getHandlerMappings(Object bean) {
            try {
                Field field = ReflectionUtils.findField(bean.getClass(), "handlerMappings");
                field.setAccessible(true);
                return (List<RequestMappingInfoHandlerMapping>) field.get(bean);
            } catch (IllegalArgumentException | IllegalAccessException e) {
                throw new IllegalStateException(e);
            }
        }
    };
}

4. 跨域问题

跨域配置 config.setAllowCredentials(true); 之后 就不能设置 config.addAllowedOrigin(“*”); 需要用 config.addAllowedOriginPattern(“*”); 代替

@Configuration
public class GlobalCorsConfig {

    /**
     * 允许跨域调用的过滤器
     */
    @Bean
    public CorsFilter corsFilter() {
        CorsConfiguration config = new CorsConfiguration();
        //允许所有域名进行跨域调用
        config.addAllowedOriginPattern(CorsConfiguration.ALL);
        //允许跨越发送cookie
        config.setAllowCredentials(true);
        //放行全部原始头信息
        config.addAllowedHeader("*");
        //允许所有请求方法跨域调用
        config.addAllowedMethod("*");
        UrlBasedCorsConfigurationSource source = new UrlBasedCorsConfigurationSource();
        source.registerCorsConfiguration("/**", config);
        return new CorsFilter(source);
    }
}

因为 org.springframework.web.cors.CorsConfiguration 的 validateAllowCredentials 方法 如下

public void validateAllowCredentials() {
    if (this.allowCredentials == Boolean.TRUE && this.allowedOrigins != null && this.allowedOrigins.contains("*")) {
        throw new IllegalArgumentException("When allowCredentials is true, allowedOrigins cannot contain the special value \"*\" since that cannot be set on the \"Access-Control-Allow-Origin\" response header. To allow credentials to a set of origins, list them explicitly or consider using \"allowedOriginPatterns\" instead.");
    }
}

5. quartz 报错 DataSource name not set

错误信息：org.quartz.SchedulerConfigException: DataSource name not set.

解决方法：

JobStore配置 springboot>2.5.6后 spring.quartz.properties.org.quartz.jobStore.class 使用 org.springframework.scheduling.quartz.LocalDataSourceJobStore

spring：
  quartz:
    # quartz db schema
    job-store-type: jdbc
    #quartz第一次启动时需要初始化，使用always，之后使用never
    #jdbc.initialize-schema=never
    jdbc.initialize-schema: always
    auto-startup: true
    startup-delay: 30s
    #quartz参数
    properties:
      org:
        quartz:
          scheduler:
            instanceName: SubmissionScheduler
            instanceId: AUTO
          #JobStore配置
          jobStore:
            #class: org.quartz.impl.jdbcjobstore.JobStoreTX 改为 LocalDataSourceJobStore
            class: org.springframework.scheduling.quartz.LocalDataSourceJobStore
            driverDelegateClass: org.quartz.impl.jdbcjobstore.PostgreSQLDelegate
            tablePrefix: QRTZ_
            isClustered: true
            clusterCheckinInterval: 15000
            maxMisfiresToHandleAtATime: 1
            useProperties: false
            dataSource: quartz
            misfireThreshold: 12000
            selectWithLockSQL: 'SELECT * FROM {0} LOCKS UPDLOCK WHERE LOCK_NAME = ?'
          #线程池配置
          threadPool:
            class: org.quartz.simpl.SimpleThreadPool
            threadCount: 20
            threadPriority: 5
            threadsInheritContextClassLoaderOfInitializingThread: true