SpringMvc项目接入SpringCloud微服务的解决方案

不念不忘少年蓝@ 2022-01-27 11:09 1008阅读 0赞

# SpringMvc项目接入SpringCloud微服务的解决方案 #

> 在SpringBoot项目大行其道的时代，仍有很多项目是基于SpringMvc，甚至是基于struts的，这些项目的特点是**年代久远，项目庞大，设计文档存在缺漏**。但是对于这些项目，我们不能放任不管，甚至很多项目还在为公司创造这价值。  
> 随着公司业务的发展，原先的单体项目已经不能满足快速发展变化的业务的需求，这时候就要进行微服务改造。

### 方案一：Sidecar异构接入 ###

![Sidecar异构架构][Sidecar]  
Sidecar项目可以看作老项目的影子项目，由Sidecar负责接入注册中心，并且发起远程调用和被远程调用。两个项目为一个整体对外提供服务。

#### 优势： ####

1.  sidecar可以无视语言，可以用于代理古老的java项目，也可以异构代理其他语言项目，如php、python、nodejs等
2.  sidecar可以在不对老项目进行大规模改造的情况下快速接入SpringCloud微服务，渐进式的做微服务拆分

#### 劣势 ####

1.  增加项目架构和维护的复杂度，多一个项目多一个环境意味着出问题的概率又多一分

#### Sidecar项目配置 ####

1.  老项目添加HealthController

/** * @Usage: 用于健康检查 */
    @RestController
    public class HealthController { 
        @RequestMapping("/openapi/health/status")
        public Map status(){ 
            Map<String, String> map = new HashMap<>(1);
            map.put("status","UP");
            return map;
        }
    }

1.  新建sidecar maven项目
2.  引入依赖

<dependencies>
        
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-netflix-sidecar</artifactId>
            <version>2.1.0.RELEASE</version>
        </dependency>
        
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-starter-netflix-eureka-client</artifactId>
            <version>2.1.0.RELEASE</version>
        </dependency>
        
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-starter-netflix-hystrix</artifactId>
            <version>2.1.0.RELEASE</version>
        </dependency>
        
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-starter-openfeign</artifactId>  
            <version>2.1.0.RELEASE</version>
        </dependency>
    </dependencies>

1.  项目启动类加入如下注解

@EnableFeignClients
    @EnableSidecar

不用@EnableEurekaClient，因为@EnableSidecar中包含来eureka的注册逻辑  
5. 配置文件增加sidecar、eureka、feign、hystrix、ribbon配置  
重点讲一下sidecar配置

sidecar:
    # 配置接入web的端口
    port: 8080
    home-page-uri: http://localhost:${ sidecar.port}/
    # 配置接入web的健康检查rest接口，sidecar将请求该url，用以确定接入应用是否存活.
    health-uri: http://localhost:${ sidecar.port}/openapi/health/status

### 方案二：升级SpringBoot并集成SpringCloud组件 ###

#### 一、升级SpringBoot 1.x版本 ####

在不改动Spring版本的情况下引入SrpingBoot，将项目改造为SpringBoot项目  
SpringBoot 1.x 引用的Spring 4.x版本，而一般SpringMvc项目也是使用Spring4.x版本，如果使用Spring更老版本或未使用spring则另当别论。

#### 二、升级SpringBoot 2.x版本 ####

SpringBoot 2.x版本使用的是Spring5.x版本，升级2.x意味着升级spring并且需要解决spring升级带来的问题

#### 三、引入SpringCloud并集成SpringCloud组件 ####

#### 遇到的问题 ####

##### 集成Eureka时，Cannot create Jersey client错误 #####

问题原因：jersey 与 fastjson 某些版本冲突导致服务无法启动  
错误：

Caused by: com.sun.jersey.spi.inject.Errors$ErrorMessagesException: null

解决方案：fastjson升级到 1.2.37以上版本

[https://github.com/alibaba/fastjson/releases/tag/1.2.37][https_github.com_alibaba_fastjson_releases_tag_1.2.37]

##### 日期响应为linux时间戳 #####

> 升级SpringBoot后，原先的日期格式化失效，在不给字段加@JsonFormat注解的情况下便要思考通过全局配置来解决

**正常配置**

spring.jackson.time-zone=GMT+8
    # 指定响应数据格式
    spring.jackson.date-format=yyyy-MM-dd HH:mm:ss
    # 指定不返回时间戳
    spring.jackson.serialization.write-dates-as-timestamps=false

这样配置后并没有生效，继续查找原因。

> Finally, if you opt out of the Spring Boot default MVC configuration by providing your own @EnableWebMvc configuration, you can take control completely and do everything manually by using getMessageConverters from WebMvcConfigurationSupport.  
> 《Spring Boot Reference Guide》

去掉@EnableWebMvc后，配置可以生效。

结合WebMvcAutoConfiguration理解@EnableWebMvc

[Sidecar]: /images/20220127/1fc6886d79d94386b72a9ee8555ad8e8.png
[https_github.com_alibaba_fastjson_releases_tag_1.2.37]: https://github.com/alibaba/fastjson/releases/tag/1.2.37