好得很程序员自学网

<tfoot draggable='sEl'></tfoot>

spring cloud升级到spring boot 2.x/Finchley.RELEASE遇到的

spring boot 2.x已经出来好一阵了,而且 spring cloud 的最新release版本finchley.release,默认集成的就是spring boot 2.x,这几天将一个旧项目尝试着从低版本升级到 2.x,踩坑无数,记录一下:

显著变化:

与 spring boot 2.0.x 兼容 不支持 spring boot 1.5.x 最低要求 java 8 新增 spring cloud function 和 spring cloud gateway

一、gradle的问题

spring boot 2.x 要求gradle版本不能太旧,先把gradle升级到4.6版本,然后编译,各种问题,到gradle官网上查了下,build.gradle有几个小地方要调整

1.1 java-libary 的项目

即:纯工具包这种公用jar,plugins{}必须放在第1行(有buildscript的除外),类似:

?

1

2

3

4

5

plugins {

 

   id 'java-library'

 

}

然后按 官网的教程 ,compile最好换成implementation

?

1

2

3

4

5

dependencies {

   implementation(

       ...

   )

}

1.2 常规java项目(指带容器能独立运行的项目)

?

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

26

27

28

29

30

31

32

33

34

35

36

37

38

39

40

41

42

43

44

45

46

47

48

49

50

51

buildscript {

 

 

 

   ext {

 

     springbootversion = '2.0.1.release'

 

   }

 

 

 

   repositories {

 

     maven {

 

       url "http://maven.aliyun.com/nexus/content/groups/public/"

 

     }

 

     ...

 

   }

 

   dependencies {

 

     classpath( "org.springframework.boot:spring-boot-gradle-plugin:${springbootversion}" )

 

   }

 

}

 

 

 

apply plugin: 'java'

 

apply plugin: 'org.springframework.boot'

 

apply plugin: 'io.spring.dependency-management'

 

 

 

dependencymanagement {

 

   imports {

 

     mavenbom 'org.springframework.cloud:spring-cloud-dependencies:finchley.release'

 

   }

 

}<br>...

另外,gradle 高版本编译时,总会有一行讨厌的提示:

deprecated gradle features were used in this build, making it incompatible with gradle 5.0.

编译时,可以加参数:--warning-mode=none 禁止掉,即类似:

gradle build --warning-mode=none -x test

二、依赖jar包版本的问题

?

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

26

27

28

29

30

31

32

33

34

35

36

37

38

39

40

41

42

43

44

45

46

47

48

49

50

51

52

53

54

55

56

57

58

59

60

61

62

63

64

65

66

67

dependencies {

 

   ...

 

   implementation(

 

       ...

 

       'org.springframework.cloud:spring-cloud-starter-consul-discovery' ,

 

       'org.springframework.cloud:spring-cloud-starter-consul-config' ,

 

       'org.springframework.cloud:spring-cloud-starter-bus-kafka' ,

 

       'org.springframework.cloud:spring-cloud-starter-sleuth' ,

 

       'org.springframework.cloud:spring-cloud-sleuth-stream:1.3.4.release' ,

 

       'org.springframework.cloud:spring-cloud-starter-hystrix:1.4.4.release' ,

 

       'org.springframework.cloud:spring-cloud-netflix-hystrix-stream' ,

 

       'org.springframework.boot:spring-boot-starter-actuator' ,

 

       'org.springframework.boot:spring-boot-starter-undertow' ,

 

       'org.springframework.boot:spring-boot-starter-mail' ,

 

       'org.springframework.boot:spring-boot-starter-jdbc' ,

 

       'org.springframework.boot:spring-boot-starter-security' ,

 

       'org.slf4j:slf4j-api:1.7.25' ,

 

       'ch.qos.logback:logback-core:1.2.3' ,

 

       'org.thymeleaf:thymeleaf-spring5:3.0.9.release' ,

 

       'org.mybatis.spring.boot:mybatis-spring-boot-starter:1.3.1' ,

 

       'tk.mybatis:mapper-spring-boot-starter:1.2.4' ,

 

       'com.github.pagehelper:pagehelper-spring-boot-starter:1.2.3'

 

   )

 

   implementation( 'com.alibaba:druid:1.1.9' ) {

 

     exclude group: "com.alibaba" , module: "jconsole"

 

     exclude group: "com.alibaba" , module: "tools"

 

   }

 

   implementation( 'org.springframework.boot:spring-boot-starter-web' ) {

 

     exclude module: "spring-boot-starter-tomcat"

 

     exclude module: "spring-boot-starter-jetty"

 

   }

 

 

 

   testcompile 'org.springframework.boot:spring-boot-starter-test'

 

}

其中

'org.springframework.cloud:spring-cloud-sleuth-stream:1.3.4.release',
'org.springframework.cloud:spring-cloud-starter-hystrix:1.4.4.release',

这二项必须指定版本号,否则编译不过。(应该最新的2.x版本的jar包,还没上传到中央仓库,无法自动识别依赖),另外pagehelper这个常用的分页组件,也建议按上面的版本来配置,否则运行时,可能会报错。

三、log4j/log4j2的问题

升级到spring boot 2.x后,不管是配置log4j还是log4j2,运行时总是报堆栈溢出的error,换成logback后,启动正常,建议大家尽量采用默认的logback,依赖项的配置参考上面的。

四、datasourcebuilder类找不到的问题

spring boot 2.x把这个类换了package,所以找不到了,详情见:

https://stackoverflow.com/questions/50011577/spring-boot-2-0-0-datasourcebuilder-not-found-in-autoconfigure-jar
https://docs.spring.io/spring-boot/docs/current/api/org/springframework/boot/jdbc/datasourcebuilder.html

解决办法就是引用:org.springframework.boot:spring-boot-starter-jdbc

同时修改代码import新的package: org.springframework.boot.jdbc.datasourcebuilder

五、安全性的问题

spring boot 2.x加强了安全性,不管访问什么rest url,默认都要求登录,在application.yml里无法通过配置关闭,只能写代码调整:

?

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

26

27

28

29

30

31

32

33

34

35

import org.springframework.context.annotation.configuration;

 

import org.springframework.security.config.annotation.web.builders.httpsecurity;

 

import org.springframework.security.config.annotation.web.configuration.enablewebsecurity;

 

import org.springframework.security.config.annotation.web.configuration.websecurityconfigureradapter;

 

 

 

@configuration

 

@enablewebsecurity

 

public class securityconfiguration extends websecurityconfigureradapter {

 

   @override

 

   protected void configure(httpsecurity http) throws exception {

 

     http.authorizerequests()

 

         .anyrequest()

 

         .permitall()

 

         .and()

 

         .csrf()

 

         .disable();

 

   }

 

}

这样,默认所有url都允许访问(如果是暴露在外网的服务,请慎用) 

六、各类actuator监控endpoint的路径变化

spring boot 2.x 里,actuator的endpoint默认路径变成/actuator开头,如果要使用以前的风格,放在/根下,可以在applicatino.yml里参考下面的配置:

?

1

2

3

4

5

6

7

8

9

10

11

12

13

management:

 

  ...

 

  endpoints:

 

   web:

 

    base-path: /

 

    exposure:

 

     include: "*"

另外/health节点,默认情况下,只能输出很少的信息,详细信息,需要通过配置打开

?

1

2

3

4

5

6

7

8

9

10

11

management:

 

  ...

 

  endpoint:

 

   health:

 

    show-details: always

 

  ...

七、${spring.cloud.client.ipaddress} 无法识别

spring cloud 2.x里,${spring.cloud.client.ipaddress} 这个写法不识别,一启动就会报错,尝试了多次,无意发现,把a改成小写,居然可以了:

?

1

2

3

4

5

6

7

spring:

 

  ...

 

  application:

 

   name: sr-menu-service:${spring.cloud.client.ipaddress}

感觉这应该是个bug,新版本里估计会修复。

八、metricwriter、systempublicmetrics类找不到的问题

spring boot 2.x里metrics默认换成了micrometer,原来的metricwriter之类的全干掉了,详情参考官网文档

 

?

1

2

3

4

5

6

7

8

9

10

11

12

13

management:

 

  metrics:

 

   export:

 

    statsd:

 

     host: 10.0 .*.*

 

     port: 8125

 

     flavor: etsy

上面的配置是启用statsd,然后跑起来就能看到效果,见下图

但是与spring boot 1.x相比,并不会直接输出具体值,要看具体值,可以用http://localhost:8001/metrics/jvm.memory.used

这其中的value中是jvm占用的内存(包括heap + noheap),如果只想看heap区(即:堆上的内存),可以用

http://localhost:8001/metrics/jvm.memory.used?tag=area:heap

同时在grafana里也能看到效果:

注:目前statsd里的前缀无法修改,代码写死的statsd

如果一台机器上部署多个spring cloud 微服务,grafana里就分不出来了(个人估计以后会改进)。

另外,如果希望通过代码获取这些metrics里具体指标值,可以参考下面的代码:

?

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

26

27

28

29

30

31

32

33

34

35

36

37

38

39

40

41

42

43

44

45

46

47

48

49

50

51

52

53

54

55

56

57

58

59

60

61

62

63

64

65

66

67

68

69

70

71

72

73

74

75

76

77

78

79

import io.micrometer.core.instrument.meter;

 

import io.micrometer.core.instrument.meterregistry;

 

import io.micrometer.core.instrument.statistic;

 

import org.junit.test;

 

import org.springframework.beans.factory.annotation.autowired;

 

 

 

import java.util.linkedhashmap;

 

import java.util.map;

 

import java.util.function.bifunction;

 

 

 

public class metricstest extends basetest {

 

 

 

   private string metric_msg_format = "metric >> %s = %d" ;

 

 

 

   @autowired

 

   private meterregistry meterregistry;

 

 

 

   @test

 

   public void teststatsdconfig() {

 

     string metric = "jvm.memory.used" ;

 

     meter meter = meterregistry.find(metric).meter();

 

     map<statistic, double > stats = getsamples(meter);

 

     logger.info(string.format(metric_msg_format, metric, stats.get(statistic.value).longvalue()));

 

   }

 

 

 

   private map<statistic, double > getsamples(meter meter) {

 

     map<statistic, double > samples = new linkedhashmap<>();

 

     mergemeasurements(samples, meter);

 

     return samples;

 

   }

 

 

 

   private void mergemeasurements(map<statistic, double > samples, meter meter) {

 

     meter.measure().foreach((measurement) -> samples.merge(measurement.getstatistic(),

 

         measurement.getvalue(), mergefunction(measurement.getstatistic())));

 

   }

 

 

 

   private bifunction< double , double , double > mergefunction(statistic statistic) {

 

     return statistic.max.equals(statistic) ? double ::max : double ::sum;

 

   }

 

}

九、swagger里webmvcconfigureradapter过时的问题

webmvcconfigureradapter这个类在最新的spring boot里已经被标识为过时,正常用法参考以下:

?

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

26

27

28

29

30

31

32

33

34

35

36

37

38

39

40

41

42

43

44

45

46

47

48

49

50

51

52

53

54

55

56

57

58

59

60

61

62

63

64

65

66

67

68

69

70

71

72

73

74

75

76

77

78

79

80

81

82

83

84

85

86

87

88

89

90

91

92

93

94

95

96

97

import org.springframework.context.annotation.bean;

 

import org.springframework.context.annotation.configuration;

 

import org.springframework.web.servlet.config.annotation.resourcehandlerregistry;

 

import org.springframework.web.servlet.config.annotation.webmvcconfigurationsupport;

 

import springfox.documentation.builders.apiinfobuilder;

 

import springfox.documentation.builders.pathselectors;

 

import springfox.documentation.builders.requesthandlerselectors;

 

import springfox.documentation.service.apiinfo;

 

import springfox.documentation.service.contact;

 

import springfox.documentation.spi.documentationtype;

 

import springfox.documentation.spring.web.plugins.docket;

 

import springfox.documentation.swagger2.annotations.enableswagger2;

 

 

 

/**

 

  * @author yangjunming

 

  * @date 13/10/2017

 

  */

 

@configuration

 

@enableswagger2

 

public class swaggerconfig extends webmvcconfigurationsupport {

 

 

 

   @override

 

   protected void addresourcehandlers(resourcehandlerregistry registry) {

 

     registry.addresourcehandler( "swagger-ui.html" )

 

         .addresourcelocations( "classpath:/meta-inf/resources/" );

 

 

 

     registry.addresourcehandler( "/webjars/**" )

 

         .addresourcelocations( "classpath:/meta-inf/resources/webjars/" );

 

   }

 

 

 

   @bean

 

   public docket createrestapi() {

 

     return new docket(documentationtype.swagger_2)

 

         .apiinfo(apiinfo())

 

         .select()

 

         .apis(requesthandlerselectors.basepackage( "sr.service.menu.controller" ))

 

         .paths(pathselectors.any())

 

         .build();

 

   }

 

 

 

   private apiinfo apiinfo() {

 

     return new apiinfobuilder()

 

         .title( "menu-service online api document" )

 

         .description( "测试服务" )

 

         .contact( new contact( "菩提树下的杨过" , "http://yjmyzz.cnblogs.com/" , "yjmyzz@126.com" ))

 

         .version( "1.0.0" )

 

         .build();

 

   }

 

}

附:一些参考文档:

https://github.com/spring-projects/spring-boot/wiki/Spring-Boot-2.0-Migration-Guide

https://spring.io/blog/2017/09/15/security-changes-in-spring-boot-2-0-m4

https://github.com/spring-projects/spring-boot/wiki/Spring-Boot-Security-2.0

https://docs.spring.io/spring-boot/docs/2.0.4.RELEASE/reference/htmlsingle/

https://github.com/pagehelper/pagehelper-spring-boot

以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持。

原文链接:http://www.cnblogs.com/yjmyzz/p/9408700.html

查看更多关于spring cloud升级到spring boot 2.x/Finchley.RELEASE遇到的的详细内容...

  阅读:41次