Spring Cloud升級最新Finchley版本的所有坑
Spring Boot 2.x 已經(jīng)發(fā)布了很久,現(xiàn)在 Spring Cloud 也發(fā)布了 基于 Spring Boot 2.x 的 Finchley 版本,現(xiàn)在一起為項目做一次整體框架升級。
升級前 => 升級后
Spring Boot 1.5.x => Spring Boot 2.0.2
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
因為配置中心需要作為服務(wù)注冊到注冊中心,所以需要升級 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 獲取服務(wù)客戶端 IP 地址配置變更了。
升級前:
${spring.cloud.client.ipAddress}
升級后:
${spring.cloud.client.ip-address}
Spring Security
一般注冊中心、配置中心都會使用安全加密,就會依賴 spring-boot-starter-security 組件,升級后有幾下兩個問題。
1、用戶名和密碼無法登錄
因為 Spring Security 的參數(shù)進(jìn)行了變更。
升級前:
security: user: name: password:
升級后:
spring:
security:
user:
name:
password:
2、注冊中心沒有注冊實例
如圖所示,沒有注冊實例,兩個注冊中心無法互相注冊。

因為 Spring Security 默認(rèn)開啟了所有 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、配置中心無法加解密
升級后發(fā)現(xiàn)訪問配置中心無法讀取到配置,也無法加解密配置信息,訪問配置中心鏈接直接跳轉(zhuǎn)到了登錄頁面。

現(xiàn)在想變回之前的 basic auth 認(rèn)證方式,找源碼發(fā)現(xiàn)是自動配置跳到了登錄頁面,現(xiàn)在重寫一下。
自動配置源碼:
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 認(rèn)證方式,如下圖所示。

現(xiàn)在我們又可以使用以下命令加解密了。
如解密:
curl http://xx.xx.xx.xx:7100/decrypt -d secret -u user:password
恢復(fù) basic auth 之后,之前的服務(wù)需要加密連接配置中心的又正常運行了。
Maven
升級到 Spring Boot 2.x 之后發(fā)現(xiàn) Spring Boot 的 Maven 啟動插件不好用了,主要是 Profile 不能自由切換。
升級前:
spring-boot:run -Drun.profiles=profile1
升級后:
spring-boot:run -Dspring-boot.run.profiles=profile1
具體的請參考:https://docs.spring.io/spring-boot/docs/current/maven-plugin/run-mojo.html
Failed to bind properties under ‘eureka.instance.instance-id' to java.lang.String:
Description:
Failed to bind properties under 'eureka.instance.instance-id' to java.lang.String:
Property: eureka.instance.instance-id
Value: ${spring.cloud.client.ipAddress}:${spring.application.name}:${spring.application.instance_id:${server.port}}
Origin: "eureka.instance.instance-id" from property source "bootstrapProperties"
Reason: Could not resolve placeholder 'spring.cloud.client.ipAddress' in value "${spring.cloud.client.ipAddress}:${spring.application.name}:${spring.application.instance_id:${server.port}}"
spring.cloud.client.ipAddress這個參數(shù)已經(jīng)不能被識別了
我們來看看源碼:
# org.springframework.cloud.client.HostInfoEnvironmentPostProcessor
@Override
public void postProcessEnvironment(ConfigurableEnvironment environment,
SpringApplication application) {
InetUtils.HostInfo hostInfo = getFirstNonLoopbackHostInfo(environment);
LinkedHashMap<String, Object> map = new LinkedHashMap<>();
map.put("spring.cloud.client.hostname", hostInfo.getHostname());
map.put("spring.cloud.client.ip-address", hostInfo.getIpAddress());
MapPropertySource propertySource = new MapPropertySource(
"springCloudClientHostInfo", map);
environment.getPropertySources().addLast(propertySource);
}
發(fā)現(xiàn)原來的ipAddress已經(jīng)改為ip-address,那么我們在配置中心做相應(yīng)的改正即可。
注:改為ip-address不會對之前的老版本的項目產(chǎn)生影響,會自動解析并正確賦值
總結(jié)
以上都是踩完所有的坑總結(jié)出來的解決方案,實際解決問題的過程遠(yuǎn)要復(fù)雜的多。版本變化有點大,本次已成功升級了 Spring Cloud 基礎(chǔ)依賴,及注冊中心(Eureka Server)、配置中心(Config Server)。
其他像 Gateway 代替了 Zuul, 及其他組件再慢慢升級,Spring Cloud 的快速發(fā)展令升級變得非常蛋疼,本文記錄了升級過程中踩過的所有的坑。。。
坑死了,已經(jīng)保證編譯、運行正常,其他還有什么坑不知道,剛升級完 Finchley 這個正式版本,Spring Cloud 剛剛又發(fā)布了 Finchley.SR1,感覺 Spring Cloud 變成了學(xué)不動系列了。。。
以上就是本文的全部內(nèi)容,希望對大家的學(xué)習(xí)有所幫助,也希望大家多多支持腳本之家。
相關(guān)文章
關(guān)于log4j日志擴(kuò)展---自定義PatternLayout
這篇文章主要介紹了關(guān)于log4j日志擴(kuò)展---自定義PatternLayout,具有很好的參考價值,希望對大家有所幫助。如有錯誤或未考慮完全的地方,望不吝賜教2021-12-12
如何解決maven搭建一直處于running:..狀態(tài)問題
在使用Maven搭建項目時,有時會遇到一直處于加載狀態(tài)的情況,通過修改設(shè)置可以解決這個問題,具體步驟為:1. 打開File->Settings->Build, Execution, Deployment->Maven->running,然后在VMOptions中填寫"-DarchetypeCatalog=internal"2024-09-09
Spring?Data?JPA框架快速入門之自定義Repository接口
Spring?Data?JPA是Spring基于JPA規(guī)范的基礎(chǔ)上封裝的?套?JPA?應(yīng)?框架,可使開發(fā)者?極簡的代碼即可實現(xiàn)對數(shù)據(jù)庫的訪問和操作,本篇我們來了解Spring?Data?JPA框架的自定義Repository接口2022-04-04
javafx 如何將項目打包為 Windows 的可執(zhí)行文件exe
文章介紹了三種將JavaFX項目打包為.exe文件的方法:方法1使用jpackage(適用于JDK14及以上版本),方法2使用Launch4j(適用于所有JDK版本),方法3使用InnoSetup(用于創(chuàng)建安裝包),每種方法都有其特點和適用范圍,可以根據(jù)項目需求選擇合適的方法,感興趣的朋友一起看看吧2025-01-01
Spring Cloud @RefreshScope 原理及使用
這篇文章主要介紹了Spring Cloud @RefreshScope 原理及使用,文中通過示例代碼介紹的非常詳細(xì),對大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價值,需要的朋友們下面隨著小編來一起學(xué)習(xí)學(xué)習(xí)吧2020-01-01
MyBatisPlus數(shù)據(jù)權(quán)限控制實現(xiàn)的三種方式
數(shù)據(jù)權(quán)限是保障數(shù)據(jù)安全的重要手段,本文主要介紹了MyBatisPlus數(shù)據(jù)權(quán)限控制實現(xiàn)的三種方式,具有一定的參考價值,具有一定的參考價值,感興趣的可以了解一下2024-05-05

