给你们聊一聊云收藏从 Spring Boot 1.0 升级到 2.0 所踩的坑

先给你们晒一下云收藏的几个数据，做为一个 Spring Boot 的开源项目（https://github.com/cloudfavorites/favorites-web）目前在 Github 上面已经有1600多个 Star，若是按照 SpringBoot 标签进行筛选的话也能够排到第五位。

当云收藏1.0开发完成以后，同步将云收藏部署到了服务器上，申请了一个域名www.favorites.ren方便你们使用，到目前为止：网站的注册用户4000多人，共计收藏文章100000多条，在百度上搜索：云收藏，排在第一的就是云收藏的官网。2年多的时间这个数据其实也并非很耀眼，可是做为一个学习 Spring Boot 的开源软件来说，已经不错了。

云收藏的部署之路也挺曲折，刚开始的时候部署在我之前公司的服务器上，后来离职的时候在阿里云买了个1核1G的云服务器，由于安装了 Mysql、Redis、还有其它小软件致使服务器很是卡，那段时间访问云收藏的时候须要等待2-3秒才会有响应。

终于有一天本身也不能忍了，花钱把服务器升级到2核2G，访问速度虽有所提高但仍是很不理想，那段时间工做很忙也没时间优化。网站的 Bug 也是一片，有时候还会忽然中断服务几个小时，流失了一大批用户，甚至有人在 Github 上面留言说：看来微笑哥已经放弃云收藏了，我看了以后只能苦笑。

到了今年 Spring Boot 2.0 发布的时候，我就计划着把云收藏全面升级到2.0，顺便作一些优化让访问速度快一点。但一拖就是2个月，终于在前几个周末抽出了一点时间，将云收藏升级到了 Spring Boot 2.0 同时修复了一批显而易见的 Bug ,使用 Nginx 将静态图片等资源作了代理，当这些工做彻底作完的时候，云收藏的访问速度明显获得了提高，你们能够访问www.favorites.ren体验一下。

将云收藏从 Spring Boot 1.0 升级到 2.0 的时候也遇到了一些问题，在修改的过程当中记录下来，今天整理一下分享出来，方便后续升级的朋友少踩一些坑。

一、第一个问题：启动类报错

Spring Boot 部署到 Tomcat 中去启动时须要在启动类添加SpringBootServletInitializer，2.0 和 1.0 有区别。

// 1.0
import org.springframework.boot.web.support.SpringBootServletInitializer;
// 2.0
import org.springframework.boot.web.servlet.support.SpringBootServletInitializer;

@SpringBootApplication
public class UserManageApplication extends SpringBootServletInitializer {
    @Override
    protected SpringApplicationBuilder configure(SpringApplicationBuilder application) {
        return application.sources(UserManageApplication.class);
    }

    public static void main(String[] args) throws Exception {
        SpringApplication.run(UserManageApplication.class, args);
    }
}

这个问题好解决只须要从新导包就行。

二、日志类报错：Spring Boot 2.0 默认不包含 log4j，建议使用 slf4j 。

import org.apache.log4j.Logger;
protected Logger logger = Logger.getLogger(this.getClass());

改成：

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
protected Logger logger =  LoggerFactory.getLogger(this.getClass());

这个也比较好改动，就是须要替换的文件比较多。

三、Spring Boot 2.0 去掉了findOne()方法。

之前的findOne()方法其实就是根据传入的 Id 来查找对象，因此在 Spring Boot 2.0 的 Repository 中咱们能够添加findById(long id)来替换使用。

例如：

User user=userRepository.findOne(Long id)

改成手动在userRepository手动添加findById(long id)方法，使用时将findOne()调用改成findById(long id)

User user=userRepository.findById(long id)

delete()方法和findOne()相似也被去掉了，可使用deleteById(Long id)来替换，还有一个不一样点是deleteById(Long id)默认实现返回值为void。

Long deleteById(Long id);

改成

//delete 改成 void 类型
void deleteById(Long id);

固然咱们还有一种方案能够解决上述的两种变化，就是自定义 Sql，可是没有上述方案简单不建议使用。

@Query("select t from Tag t where t.tagId = :tagId")
Tag getByTagId(@Param("tagId") long tagId);

四、云收藏升级到 2.0 以后，插入数据会报错，错误信息以下：

org.springframework.dao.DataIntegrityViolationException: could not execute statement; SQL [n/a]; constraint [PRIMARY]; nested exception is org.hibernate.exception.ConstraintViolationException: could not execute statement
....
Caused by: org.hibernate.exception.ConstraintViolationException: could not execute statement
...
Caused by: com.mysql.jdbc.exceptions.jdbc4.MySQLIntegrityConstraintViolationException: Duplicate entry '299' for key 'PRIMARY'

这个问题稍稍花费了一点时间，报错提示的是主键冲突，跟踪数据库的数据发现并无主键冲突，最后才发现是 Spring Boot 2.0 须要指定主键的自增策略，这个和 Spring Boot 1.0 有所区别，1.0 会使用默认的策略。

@Id
@GeneratedValue(strategy= GenerationType.IDENTITY)
private long id;

改动也比较简单，须要在全部的主键上面显示的指明自增策略。

五、Thymeleaf 3.0 默认不包含布局模块。

这个问题比较尴尬，当我将 Pom 包升级到 2.0 以后，访问首页的时候一片空白什么都没有，查看后台也没有任何的报错信息，首先尝试着跟踪了 http 请求，对比了一下也没有发现什么异常，在查询 Thymeleaf 3.0 变化时才发现：Spring Boot 2.0 中spring-boot-starter-thymeleaf 包默认并不包含布局模块，须要使用的时候单独添加，添加布局模块以下：

<dependency>
   <groupId>nz.net.ultraq.thymeleaf</groupId>
   <artifactId>thymeleaf-layout-dialect</artifactId>
</dependency>

改完以后再访问首页，一切正常，可是回头查看日志信息发现有一个告警信息：

2018-05-10 10:47:00.029  WARN 1536 --- [nio-8080-exec-2] n.n.u.t.decorators.DecoratorProcessor    : The layout:decorator/data-layout-decorator processor has been deprecated and will be removed in the next major version of the layout dialect.  Please use layout:decorate/data-layout-decorate instead to future-proof your code.  See https://github.com/ultraq/thymeleaf-layout-dialect/issues/95 for more information.
2018-05-10 10:47:00.154  WARN 1536 --- [nio-8080-exec-2] n.n.u.t.expressions.ExpressionProcessor  : Fragment expression "layout" is being wrapped as a Thymeleaf 3 fragment expression (~{...}) for backwards compatibility purposes.  This wrapping will be dropped in the next major version of the expression processor, so please rewrite as a Thymeleaf 3 fragment expression to future-proof your code.  See https://github.com/thymeleaf/thymeleaf/issues/451 for more information.

跟踪地址看了一下，大概的意思是之前布局的标签已通过期了，推荐使用新的标签来进行页面布局，解决方式也比较简单，修改之前的布局标签 layout:decorator 为 layout:decorate便可。

六、分页组件PageRequest变化。

在 Spring Boot 2.0 中 ，方法new PageRequest(page, size, sort) 已通过期再也不推荐使用，推荐使用如下方式来构建分页信息：

Pageable pageable =PageRequest.of(page, size, Sort.by(Sort.Direction.ASC,"id"));

跟踪了一下源码发现PageRequest.of()方法，内部仍是使用的new PageRequest(page, size, sort)，只是最新的写法更简洁一些。

public static PageRequest of(int page, int size, Sort sort) {
    return new PageRequest(page, size, sort);
}

七、关联查询时候组合返回对象的默认值有变化。

在使用 Spring Boot 1.0 时，使用 Jpa 关联查询时咱们会构建一个接口对象来接收结果集，相似以下：

public interface CollectView{
   Long getId();
   Long getUserId();
   String getProfilePicture();
   String getTitle();
}

在使用 Spring Boot 1.0 时，若是没有查询到对应的字段会返回空，在 Spring Boot 2.0 中会直接报空指针异常，对结果集的检查会更加严格一些。

八、其它优化

前段时间在学习 Docker ，给云收藏添加了 Docker 、Docker Compose 支持让部署的时候更简单一些；同时修复了一些 bug，对于明显很消耗资源的功能进行了改进，部分功能添加了容错性；本次部署的时候使用了 Nginx 做为反向代理，由于使用了 WebJars 暂时不能使用 Nginx 代理 Js，因此将除过 Js 之外的其它资源都配置了缓存，；数据库由 Mysql 换成了 Mariadb。

以上就是云收藏从 Spring Boot 1.0 到 2.0 所作的一些小改进，作完这些工做以后惊喜的发现云收藏的访问速度比之前快了不少，虽然还有很大的优化空间，但平常使用基本上不会体验到太大的延迟。Spring Boot 2.0 中 Thymeleaf 默认使用了 3.0 ，数据库链接池默认使用了 Hikari ，这两个组件在性能上有很大的提高，同时也是提高云收藏访问速度的因素之一。

将来云收藏还会持续升级，后续会规划一些面向程序员的新功能，敬请期待！

固然了若是你们想系统学习Spring Boot 欢迎关注我在51CTO的课程：微服务技术架构和大数据治理实战

此专栏之会介绍微服务架构实践、Spring Boot 和 MongoDB 使用、微服务架构下数据处理有进一步的了解，具有使用 Spring Boot 开发微服务项目、利用相关技术解决微服务架构中数据治理的疼点。

专栏地址:微服务技术架构和大数据治理实战