SpringCloud微服务踩坑系列之一

偏执的太偏执、 2024-02-19 12:13 46阅读 0赞

之前我在公司的项目中开发使用的Spring Boot是1.5.x版本,现在 2.x 已经发布了挺久，而Spring Cloud 也发布了 基于 Spring Boot 2.x 的 Finchley 版本，所以我把我们公司的项目自己做了一次重构,对整体框架进行了一次升级改造,在改造过程中,也踩了不少的坑,特记录如下.

**升级前 => 升级后**

Spring Boot 1.5.x => Spring Boot 2.0.3

Spring Cloud Edgware SR4 => Spring Cloud Finchley.RELEASE

#### 一.Eureka Server ####

**Eureka Server 依赖更新**

升级前：

<dependency>
        <groupId>org.springframework.cloud</groupId>
        <artifactId>spring-cloud-starter-eureka-server</artifactId>
    </dependency>

升级后：

<dependency>
        <groupId>org.springframework.cloud</groupId>
        <artifactId>spring-cloud-starter-netflix-eureka-server</artifactId>
    </dependency>

#### 二.Eureka Client ####

因为配置中心需要作为eureka的服务实例注册到eureka服务中心，所以需要升级 Eureka Client，其他依赖没有变动。

**Eureka Client 依赖更新**

升级前：

<dependency>
        <groupId>org.springframework.cloud</groupId>
        <artifactId>spring-cloud-starter-eureka</artifactId>
    </dependency>

升级后：

<dependency>
        <groupId>org.springframework.cloud</groupId>
        <artifactId>spring-cloud-starter-netflix-eureka-client</artifactId>
    </dependency>

#### 三.Spring Cloud ####

**注册中心里面的客户端实例IP显示不正确**

因为 Spring Cloud 获取服务客户端 IP 地址配置变更了。

升级前：

${spring.cloud.client.ipAddress}

升级后：

${spring.cloud.client.ip-address}

#### 四.Spring Security ####

一般注册中心、配置中心都会使用安全加密，就会依赖 `spring-boot-starter-security` 组件，升级后有几下两个问题。

**1、用户名和密码无法登录**

因为 Spring Security 的参数进行了变更。

升级前：

security:
      user:
        name:
        password:

升级后：

spring:
      security:
         user:
           name: 
           password:

另外需要注意:

SpringBoot项目遵循的是约定大于配置的原则,当pom.xml文件中添加了security的依赖后,就会自动启用eureka的安全验证功能,否则就不会开启.

<dependency>
        <groupId>org.springframework.cloud</groupId> 
        <artifactId>spring-cloud-starter-security</artifactId>
     </dependency>

**2、注册中心没有注册实例**

如图所示，没有注册实例，两个注册中心无法互相注册。

![Spring Cloud 升级最新 Finchley 版本，踩了所有的坑！][Spring Cloud _ Finchley]

因为 Spring Security 默认开启了所有 CSRF ×××防御，需要禁用 /eureka 的防御。

在 Application 入口类增加忽略配置：

@EnableWebSecurity
    static class WebSecurityConfig extends WebSecurityConfigurerAdapter {
    
        @Override
        protected void configure(HttpSecurity http) throws Exception {
            http.csrf().ignoringAntMatchers("/eureka/**");
            super.configure(http);
        }
    }

**3、配置中心无法加解密**

升级后发现访问配置中心无法读取到配置，也无法加解密配置信息，访问配置中心链接直接跳转到了登录页面。

![Spring Cloud 升级最新 Finchley 版本，踩了所有的坑！][Spring Cloud _ Finchley 1]

现在想变回之前的 basic auth 认证方式，找源码发现是自动配置跳到了登录页面，现在重写一下。

> 自动配置源码：  
> org.springframework.security.config.annotation.web.configuration.WebSecurityConfigurerAdapter\#configure(org.springframework.security.config.annotation.web.builders.HttpSecurity)

protected void configure(HttpSecurity http) throws Exception {
        logger.debug("Using default configure(HttpSecurity). If subclassed this will potentially override subclass configure(HttpSecurity).");
    
        http
            .authorizeRequests()
                .anyRequest().authenticated()
                .and()
            .formLogin().and()
            .httpBasic();
    }

重写之后：

@EnableWebSecurity
    static class WebSecurityConfig extends WebSecurityConfigurerAdapter {
    
        @Override
        protected void configure(HttpSecurity http) throws Exception {
            http.csrf().ignoringAntMatchers("/**").and().authorizeRequests().anyRequest()
                    .authenticated().and().httpBasic();
        }
    
    }

其实就是把 `formLogin()` 干掉了，又回到之前的 basic auth 认证方式，如下图所示。

![Spring Cloud 升级最新 Finchley 版本，踩了所有的坑！][Spring Cloud _ Finchley 2]

现在我们又可以使用以下命令加解密了。

> 如解密：  
> curl [http://xx.xx.xx.xx:7100/decrypt][http_xx.xx.xx.xx_7100_decrypt] \-d secret -u user:password

恢复 basic auth 之后，之前的服务需要加密连接配置中心的又正常运行了。

#### Maven ####

升级到 Spring Boot 2.x 之后发现 Spring Boot 的 Maven 启动插件不好用了，主要是 Profile 不能自由切换。

升级前：

spring-boot:run -Drun.profiles=profile1

升级后：

spring-boot:run -Dspring-boot.run.profiles=profile1

[Spring Cloud _ Finchley]: http://p179cyr45.bkt.clouddn.com/18-8-1/42415130.jpg
[Spring Cloud _ Finchley 1]: http://p179cyr45.bkt.clouddn.com/18-8-3/35230831.jpg
[Spring Cloud _ Finchley 2]: http://p179cyr45.bkt.clouddn.com/18-8-3/81574886.jpg
[http_xx.xx.xx.xx_7100_decrypt]: http://xx.xx.xx.xx:7100/decrypt