Spring Boot是最流行的用于開發(fā)微服務(wù)的Java框架拓售。在本文主要分享的是在專業(yè)開發(fā)中使用Spring Boot所采用的最佳實(shí)踐蜕煌。這些內(nèi)容是基于個(gè)人經(jīng)驗(yàn)和一些熟知的Spring Boot專家的文章欢伏。

在本文中重點(diǎn)介紹Spring Boot特有的實(shí)踐（大多數(shù)時(shí)候玻褪，也適用于Spring項(xiàng)目）阐污。以下依次列出了最佳實(shí)踐玄柠，排名不分先后突梦。

1、使用自定義BOM來維護(hù)第三方依賴

Spring Boot項(xiàng)目本身使用和集成了大量的開源項(xiàng)目羽利，它幫助我們維護(hù)了這些第三方依賴宫患。但是也有一部分在實(shí)際項(xiàng)目使用中并沒有包括進(jìn)來，這就需要我們?cè)陧?xiàng)目中自己維護(hù)版本这弧。如果在一個(gè)大型的項(xiàng)目中娃闲，包括了很多未開發(fā)模塊，那么維護(hù)起來就非常的繁瑣匾浪。

怎么辦呢皇帮？事實(shí)上，Spring IO Platform就是做的這個(gè)事情户矢，它本身就是Spring Boot的子項(xiàng)目玲献，同時(shí)維護(hù)了其他第三方開源庫。我們可以借鑒Spring IO Platform來編寫自己的基礎(chǔ)項(xiàng)目platform-bom梯浪，所有的業(yè)務(wù)模塊項(xiàng)目應(yīng)該以BOM的方式引入捌年。這樣在升級(jí)第三方依賴時(shí)，就只需要升級(jí)這一個(gè)依賴的版本而已挂洛。

<dependencyManagement>

? ?<dependencies>

? ? ? ?<dependency>

? ? ? ? ? ?<groupId>io.spring.platform</groupId>

? ? ? ? ? ?<artifactId>platform-bom</artifactId>

? ? ? ? ? ?<version>Cairo-SR3</version>

? ? ? ? ? ?<type>pom</type>

? ? ? ? ? ?<scope>import</scope>

? ? ? ?</dependency>

? ?</dependencies>

</dependencyManagement>

2礼预、使用自動(dòng)配置

Spring Boot的一個(gè)主要特性是使用自動(dòng)配置。這是Spring Boot的一部分虏劲，它可以簡化你的代碼并使之工作托酸。當(dāng)在類路徑上檢測到特定的jar文件時(shí)，自動(dòng)配置就會(huì)被激活柒巫。

使用它的最簡單方法是依賴Spring Boot Starters励堡。因此，如果你想與Redis進(jìn)行集成堡掏，你可以首先包括：

<dependency>

? ?<groupId>org.springframework.boot</groupId>

? ?<artifactId>spring-boot-starter-data-redis</artifactId>

</dependency>

如果你想與MongoDB進(jìn)行集成应结，需要這樣：

<dependency>

? ?<groupId>org.springframework.boot</groupId>

? ?<artifactId>spring-boot-starter-data-mongodb</artifactId>

</dependency>

借助于這些starters，這些繁瑣的配置就可以很好地集成起來并協(xié)同工作泉唁，而且它們都是經(jīng)過測試和驗(yàn)證的鹅龄。這非常有助于避免可怕的Jar地獄（https://dzone.com/articles/what-is-jar-hell）。

通過使用以下注解屬性亭畜，可以從自動(dòng)配置中排除某些配置類：

@EnableAutoConfiguration（exclude?= {ClassNotToAutoconfigure.class}）

但只有在絕對(duì)必要時(shí)才應(yīng)該這樣做扮休。

官方文檔可在此處找到：

https://docs.spring.io/spring-boot/docs/current/reference/html/using-boot-auto-configuration.html。

3拴鸵、使用Spring Initializr開始新項(xiàng)目

這一條最佳實(shí)踐來自Josh Long （Spring Advocate玷坠，@starbuxman）蜗搔。

Spring Initializr（https://start.spring.io/）提供了一個(gè)超級(jí)簡單的方法來創(chuàng)建一個(gè)新的Spring Boot項(xiàng)目，并根據(jù)你的需要來加載可能使用到的依賴侨糟。

使用Initializr創(chuàng)建應(yīng)用程序可確保你獲得經(jīng)過測試和驗(yàn)證的依賴項(xiàng)碍扔，這些依賴項(xiàng)適用于Spring自動(dòng)配置。你甚至可能會(huì)發(fā)現(xiàn)一些新的集成秕重，但你可能并沒有意識(shí)到這些不同。

4、考慮為常見的組織問題創(chuàng)建自動(dòng)配置

這一條也來自Josh Long（Spring Advocate溶耘，@starbuxman）——這個(gè)實(shí)踐是針對(duì)高級(jí)用戶的二拐。

如果你在一個(gè)嚴(yán)重依賴Spring Boot的公司或團(tuán)隊(duì)中工作，并且有共同的問題需要解決凳兵，那么你可以創(chuàng)建自己的自動(dòng)配置百新。

這項(xiàng)任務(wù)涉及較多工作庐扫，因此你需要考慮何時(shí)獲益是值得投入的。與多個(gè)略有不同的定制配置相比形庭，維護(hù)單個(gè)自動(dòng)配置更容易。

如果將這個(gè)提供Spring Boot配置以開源庫的形式發(fā)布出去萨醒，那么將極大地簡化數(shù)千個(gè)用戶的配置工作。

5富纸、正確設(shè)計(jì)代碼目錄結(jié)構(gòu)

盡管允許你有很大的自由，但是有一些基本規(guī)則值得遵守來設(shè)計(jì)你的源代碼結(jié)構(gòu)晓褪。

避免使用默認(rèn)包。確保所有內(nèi)容（包括你的入口點(diǎn)）都位于一個(gè)名稱很好的包中涣仿，這樣就可以避免與裝配和組件掃描相關(guān)的意外情況；

將Application.java（應(yīng)用的入口類）保留在頂級(jí)源代碼目錄中变过；

建議將控制器和服務(wù)放在以功能為導(dǎo)向的模塊中涝涤，但這是可選的。一些非常好的開發(fā)人員建議將所有控制器放在一起阔拳。

6崭孤、保持@Controller的簡潔和專注

Controller應(yīng)該非常簡單类嗤。你可以在此處閱讀有關(guān)GRASP中有關(guān)控制器模式部分的說明：

https://en.wikipedia.org/wiki/GRASP_(object-oriented_design)#Controller。

你希望控制器作為協(xié)調(diào)和委派的角色辨宠，而不是執(zhí)行實(shí)際的業(yè)務(wù)邏輯遗锣。以下是主要做法：

控制器應(yīng)該是無狀態(tài)的！默認(rèn)情況下嗤形，控制器是單例精偿，并且任何狀態(tài)都可能導(dǎo)致大量問題；

控制器不應(yīng)該執(zhí)行業(yè)務(wù)邏輯赋兵，而是依賴委托笔咽；

控制器應(yīng)該處理應(yīng)用程序的HTTP層，這不應(yīng)該傳遞給服務(wù)霹期；

控制器應(yīng)該圍繞用例/業(yè)務(wù)能力來設(shè)計(jì)叶组。

要深入這個(gè)內(nèi)容，需要進(jìn)一步地了解設(shè)計(jì)REST API的最佳實(shí)踐历造。無論你是否想要使用Spring Boot甩十，都是值得學(xué)習(xí)的。

7吭产、圍繞業(yè)務(wù)功能構(gòu)建@Service

Service是Spring Boot的另一個(gè)核心概念侣监。我發(fā)現(xiàn)最好圍繞業(yè)務(wù)功能/領(lǐng)域/用例（無論你怎么稱呼都行）來構(gòu)建服務(wù)。

在應(yīng)用中設(shè)計(jì)名稱類似AccountService, UserService, PaymentService這樣的服務(wù)垮刹，比起像DatabaseService达吞、ValidationService、CalculationService這樣的會(huì)更合適一些荒典。

你可以決定使用Controler和Service之間的一對(duì)一映射酪劫，那將是理想的情況。但這并不意味著寺董，Service之間不能互相調(diào)用覆糟！

8、使數(shù)據(jù)庫獨(dú)立于核心業(yè)務(wù)邏輯之外

我之前還不確定如何在Spring Boot中最好地處理數(shù)據(jù)庫交互遮咖。在閱讀了羅伯特·C·馬丁的“Clear Architecture”之后滩字，對(duì)我來說就清晰多了。

你希望你的數(shù)據(jù)庫邏輯于服務(wù)分離出來御吞。理想情況下麦箍，你不希望服務(wù)知道它正在與哪個(gè)數(shù)據(jù)庫通信，這需要一些抽象來封裝對(duì)象的持久性陶珠。

羅伯特C.馬丁強(qiáng)烈地說明挟裂，你的數(shù)據(jù)庫是一個(gè)“細(xì)節(jié)”，這意味著不將你的應(yīng)用程序與特定數(shù)據(jù)庫耦合揍诽。過去很少有人會(huì)切換數(shù)據(jù)庫诀蓉，我注意到，使用Spring Boot和現(xiàn)代微服務(wù)開發(fā)會(huì)讓事情變得更快渠啤。

9、保持業(yè)務(wù)邏輯不受Spring Boot代碼影響

考慮到“Clear Architecture”的教訓(xùn)份名，你還應(yīng)該保護(hù)你的業(yè)務(wù)邏輯架专。將各種Spring Boot代碼混合在一起是非常誘人的……不要這樣做。如果你能抵制誘惑想邦，你將保持你的業(yè)務(wù)邏輯可重用丧没。

部分服務(wù)通常成為庫锡移。如果不從代碼中刪除大量Spring注解淆珊，則更容易創(chuàng)建。

10往声、推薦使用構(gòu)造函數(shù)注入

這一條實(shí)踐來自Phil Webb（Spring Boot的項(xiàng)目負(fù)責(zé)人, @phillip_webb）浩销。

保持業(yè)務(wù)邏輯免受Spring Boot代碼侵入的一種方法是使用構(gòu)造函數(shù)注入听哭。 不僅是因?yàn)锧Autowired注解在構(gòu)造函數(shù)上是可選的，而且還可以在沒有Spring的情況下輕松實(shí)例化bean普筹。

11太防、熟悉并發(fā)模型

在Spring Boot中祟霍，Controller和Service是默認(rèn)是單例沸呐。如果你不小心，這會(huì)引入可能的并發(fā)問題寓娩。 你通常也在處理有限的線程池呼渣。請(qǐng)熟悉這些概念屁置。

如果你正在使用新的WebFlux風(fēng)格的Spring Boot應(yīng)用程序，我已經(jīng)解釋了它在“Spring’s WebFlux/Reactor Parallelism and Backpressure”中是如何工作的阱穗。

12揪阶、加強(qiáng)配置管理的外部化

這一點(diǎn)超出了Spring Boot患朱，雖然這是人們開始創(chuàng)建多個(gè)類似服務(wù)時(shí)常見的問題……

你可以手動(dòng)處理Spring應(yīng)用程序的配置裁厅。如果你正在處理多個(gè)Spring Boot應(yīng)用程序，則需要使配置管理能力更加強(qiáng)大倦淀。

推薦兩種主要方法：

使用配置服務(wù)器声畏，例如Spring Cloud Config插龄；

將所有配置存儲(chǔ)在環(huán)境變量中（可以基于git倉庫進(jìn)行配置）。

這些選項(xiàng)中的任何一個(gè)（第二個(gè)選項(xiàng)多一些）都要求你在DevOps更少工作量糠雨，但這在微服務(wù)領(lǐng)域是很常見的甘邀。

13、提供全局異常處理

你真的需要一種處理異常的一致方法坞琴。Spring Boot提供了兩種主要方法：

你應(yīng)該使用HandlerExceptionResolver定義全局異常處理策略逗抑；

你也可以在控制器上添加@ExceptionHandler注解，這在某些特定場景下使用可能會(huì)很有用荧关。

這與Spring中的幾乎相同忍啤，并且Baeldung有一篇關(guān)于REST與Spring的錯(cuò)誤處理的詳細(xì)文章（https://www.baeldung.com/exception-handling-for-rest-with-spring）檀轨，非常值得一讀欺嗤。

14、使用日志框架

你可能已經(jīng)意識(shí)到這一點(diǎn)讹挎，但你應(yīng)該使用Logger進(jìn)行日志記錄吆玖，而不是使用System.out.println()手動(dòng)執(zhí)行沾乘。這很容易在Spring Boot中完成，幾乎沒有配置翅阵。只需獲取該類的記錄器實(shí)例：

Logger logger = LoggerFactory.getLogger(MyClass.class);

這很重要掷匠，因?yàn)樗梢宰屇愀鶕?jù)需要設(shè)置不同的日志記錄級(jí)別。

15讹语、測試你的代碼

這不是Spring Boot特有的，但它需要提醒——測試你的代碼导匣！如果你沒有編寫測試逐抑，那么你將從一開始就編寫遺留代碼屹蚊。

如果有其他人使用你的代碼庫进每，那邊改變?nèi)魏螙|西將會(huì)變得危險(xiǎn)田晚。當(dāng)你有多個(gè)服務(wù)相互依賴時(shí)，這甚至可能更具風(fēng)險(xiǎn)芹壕。

由于存在Spring Boot最佳實(shí)踐接奈，因此你應(yīng)該考慮將Spring Cloud Contract用于你的消費(fèi)者驅(qū)動(dòng)契約序宦，它將使你與其他服務(wù)的集成更容易使用。

16潘明、使用測試切片讓測試更容易秕噪，并且更專注

這一條實(shí)踐來自Madhura Bhave（Spring 開發(fā)者, @madhurabhave23）腌巾。

使用Spring Boot測試代碼可能很棘手——你需要初始化數(shù)據(jù)層，連接大量服務(wù)城菊，模擬事物……實(shí)際上并不是那么難碉克！答案是使用測試切片。

使用測試切片况褪，你可以根據(jù)需要僅連接部分應(yīng)用程序测垛。這可以為你節(jié)省大量時(shí)間秧均，并確保你的測試不會(huì)與未使用的內(nèi)容相關(guān)聯(lián)。

來自spring.io的一篇名為Custom test slice with Spring test 1.4的博客文章

解釋了這種技術(shù)锯七。

（https://spring.io/blog/2016/08/30/custom-test-slice-with-spring-boot-1-4）