給大家聊一聊雲收藏從 Spring Boot 1.0 升級到 2.0 所踩的坑
當雲收藏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 的時候也遇到了一些問題,在修改的過程中記錄下來,今天整理一下分享出來,方便後續升級的朋友少踩一些坑。
1、第一個問題:啟動類報錯
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); } }
這個問題好解決只需要重新導包就行。
2、日誌類報錯: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());
這個也比較好改動,就是需要替換的文件比較多。
3、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);
4、雲收藏升級到 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;
改動也比較簡單,需要在所有的主鍵上面顯示的指明自增策略。
5、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
即可。
6、分頁組件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);
}
7、關聯查詢時候組合返回對象的默認值有變化。
在使用 Spring Boot 1.0 時,使用 Jpa 關聯查詢時我們會構建一個接口對象來接收結果集,類似如下:
public interface CollectView{
Long getId();
Long getUserId();
String getProfilePicture();
String getTitle();
}
在使用 Spring Boot 1.0 時,如果沒有查詢到對應的字段會返回空,在 Spring Boot 2.0 中會直接報空指針異常,對結果集的檢查會更加嚴格一些。
8、其它優化
前段時間在學習 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 1.0 升級到 2.0 所踩的坑