“SpringBoot 是什么很多人背了一堆注解卻仍然說不清楚它到底做了什么。”這是許多 Java 開發(fā)者學(xué)習(xí)路徑上最真實的狀態(tài)。大家用 RestController 寫接口、用 Service 寫業(yè)務(wù)、用 Autowired 注入對象覺得 SpringBoot 就是“Spring 的簡化版”可一旦被問到“自動裝配原理”“Starter 到底是什么”“為什么啟動一個項目不需要配置 Tomcat”就會陷入一種似懂非懂的尷尬。這篇文章想幫大家把這個問題徹底理清楚。我會從 SpringBoot 提出的背景、它在 Spring 生態(tài)中的真實定位、它替開發(fā)者做的具體事情入手再深入到自動裝配原理和后端項目落地。這是系列的第一節(jié)內(nèi)容偏“認(rèn)知框架”和“快速上手”目標(biāo)是讓你讀完不僅知道 SpringBoot 好用還能說清楚它為什么好用、好在哪里、核心機(jī)制是怎么設(shè)計的。1. SpringBoot 到底是什么不是“又一個新框架”很多初學(xué)者容易把 SpringBoot 誤認(rèn)為是一個和 Spring 并列的獨(dú)立框架這是第一個認(rèn)知誤區(qū)。實際上SpringBoot 并不是重寫了一套新框架而是構(gòu)建在 Spring Framework 之上的“開發(fā)基礎(chǔ)設(shè)施”。它做的事情用一句話概括就是讓 Spring 應(yīng)用可以“開箱即用”。你可以把 Spring Framework 理解為發(fā)動機(jī)。發(fā)動機(jī)很強(qiáng)大但把它裝到車上還需要變速箱、底盤、電氣系統(tǒng)、輪子等一系列配套。傳統(tǒng)模式下這些配套需要你手工組裝而 SpringBoot 直接提供了一輛“能開就走”的整車并且它沒有改動發(fā)動機(jī)本身。具體到技術(shù)層面SpringBoot 提供了幾個關(guān)鍵能力自動配置根據(jù)項目引入的依賴和 classpath 情況自動生成需要的 Bean。Starter 依賴管理把一組功能相關(guān)的依賴打包成“套餐”解決版本兼容問題。內(nèi)嵌 Servlet 容器項目無需外置 Tomcat、Jetty 即可獨(dú)立運(yùn)行。生產(chǎn)級運(yùn)維特性健康檢查、指標(biāo)采集、外部配置等能力內(nèi)置在框架中。這意味著SpringBoot 不是“替代 Spring”而是“重新組織 Spring 的使用方式”。你寫的業(yè)務(wù)代碼仍然是 Spring Bean你用的依賴仍然是 Spring 生態(tài)的組件只是裝配邏輯從“自己寫 XML”變成了“框架自動判斷”。這種模式一般被稱為“約定優(yōu)于配置”SpringBoot 把這種思想從口號變成了工程落地。2. 回到“配置地獄”沒有 SpringBoot 之前有多痛要理解 SpringBoot 的價值最好是回到它出現(xiàn)之前的時代。當(dāng)時一個典型的 Java Web 項目也就是我們常說的 SSMSpring Spring MVC MyBatis架構(gòu)從創(chuàng)建到啟動需要手工完成大量重復(fù)配置。在 web.xml 里配置 Spring 的 ContextLoaderListener 和 DispatcherServlet在 spring-mvc.xml 里開啟注解驅(qū)動、配置視圖解析器、靜態(tài)資源映射在 applicationContext.xml 里配置數(shù)據(jù)源、事務(wù)管理器、MyBatis 的 SqlSessionFactory 和 Mapper 掃描。這還只是基礎(chǔ)配置。如果項目要集成 Redis、消息隊列、定時任務(wù)對應(yīng)的配置會繼續(xù)膨脹。我舉一個很小的例子光是 Spring MVC 的基礎(chǔ)配置片段就足夠勸退新手!-- web.xml 中的核心配置片段 -- servlet servlet-namedispatcher/servlet-name servlet-classorg.springframework.web.servlet.DispatcherServlet/servlet-class init-param param-namecontextConfigLocation/param-name param-valueclasspath:spring-mvc.xml/param-value /init-param load-on-startup1/load-on-startup /servlet servlet-mapping servlet-namedispatcher/servlet-name url-pattern//url-pattern /servlet-mapping這還只是 web.xml 的冰山一角。除了配置本身還有兩個更折磨人的問題第一依賴版本需要手工維護(hù)。SSM 項目要引入 Spring、Spring MVC、MyBatis、MyBatis-Spring 等依賴每一個組件的版本都要自己確認(rèn)兼容性。遇到版本沖突時排查兩個 jar 之間的依賴關(guān)系會消耗大量時間而 Maven 的依賴樹卻只是冷冰冰的列表。第二部署鏈路很長。開發(fā)完代碼后需要打成 war 包再把 war 包放到本地安裝的 Tomcat 的 webapps 目錄下啟動 Tomcat才能看到效果。這個過程雖然只多了 3 到 5 步但每臺開發(fā)機(jī)的環(huán)境不同經(jīng)常出現(xiàn)“在同事電腦上能跑在我電腦上報錯”的問題。把這兩件事疊加起來一個普通的新項目從創(chuàng)建到能夠在瀏覽器里看到第一個頁面很多時候需要大半天。而 SpringBoot 出現(xiàn)后新項目從創(chuàng)建到啟動只要幾分鐘。這不是操作熟練度的問題而是整個使用范式被重寫了。3. SpringBoot 的四大動作它替開發(fā)者做了哪些事SpringBoot 實現(xiàn)“開箱即用”靠的是四個核心動作。把它們拆開看清楚你對 SpringBoot 的理解就會從“知道”變成“掌握”。3.1 Starter 起步依賴依賴管理從“點(diǎn)菜”變成“套餐”過去引入依賴是“點(diǎn)菜”邏輯我先決定要 Spring MVC再去決定要不要 Jackson還要考慮 JSON 序列化用哪個庫比較合適。每個決定都代表一次潛在的錯誤判斷。SpringBoot 換成了“套餐”邏輯。你只需要引入一個 starter例如 spring-boot-starter-web這個套餐里就自動包含了 Spring MVC、內(nèi)嵌 Tomcat、Jackson、Spring Boot 自動配置模塊等一組與 Web 開發(fā)相關(guān)的最佳實踐依賴。你不用關(guān)心具體版本SpringBoot 的依賴管理機(jī)制已經(jīng)把這些組件的兼容版本通過 spring-boot-dependencies 統(tǒng)一鎖定。這種設(shè)計最直接的收益是你只需要關(guān)心“我要做什么功能”而不是“我要引哪些 jar”。3.2 自動配置基于條件的智能默認(rèn)值自動配置是 SpringBoot 看起來“魔法”的部分。它的核心思路是框架根據(jù)你引入的依賴和當(dāng)前環(huán)境自動創(chuàng)建你“大概率需要”的 Bean。舉例來說當(dāng)你引入了 spring-boot-starter-web 并且 classpath 中包含 Spring MVC 相關(guān)類時SpringBoot 會悄悄幫你創(chuàng)建 DispatcherServlet、內(nèi)嵌 Tomcat、HandlerMapping、異常處理器等一系列 Web 開發(fā)必需的組件。你可能一個 Bean 都沒寫過但項目啟動后 Web 能力就已經(jīng)完整可用了。這個機(jī)制的關(guān)鍵在于“有條件”。自動配置并不是無條件地把所有 Bean 都注冊進(jìn)去而是通過條件注解逐個檢查只有滿足條件才裝配。這就保證了引入的功能越多項目越復(fù)雜SpringBoot 的自動裝配也能保持足夠的準(zhǔn)確性和靈活性。這部分邏輯我會在第 4 章詳細(xì)講。3.3 內(nèi)嵌 Servlet 容器應(yīng)用本身就是服務(wù)器SpringBoot 默認(rèn)把 Tomcat 以嵌入式方式打包進(jìn)應(yīng)用。也就是說你生成的 jar 包中不僅包含你的代碼也包含了一個可以直接運(yùn)行的 Servlet 容器。由于容器內(nèi)嵌部署方式徹底改變。過去是“應(yīng)用適配服務(wù)器”現(xiàn)在是“應(yīng)用直接運(yùn)行”。你可以直接在命令行執(zhí)行java -jar demo.jar也可以將 jar 包丟進(jìn) Docker 容器讓容器內(nèi)的 JDK 來執(zhí)行它。開發(fā)環(huán)境、測試環(huán)境、生產(chǎn)環(huán)境的差異被壓縮到最小。在 SpringBoot 中Tomcat 只是默認(rèn)選擇如果你想用 Jetty 或 Undertow只需要在依賴上切換對應(yīng)的 starter業(yè)務(wù)代碼一行都不用改。這個靈活性是傳統(tǒng)外置容器時代很難想象的事情。3.4 工程化能力配置體系、監(jiān)控與統(tǒng)一打包SpringBoot 在去掉大量 XML 配置的同時也沒有把配置能力丟掉而是換了一套更輕量的方式。它支持 application.properties 和 application.yml 兩種配置文件并提供多環(huán)境 profile 機(jī)制你可以用 application-dev.yml、application-prod.yml 把不同環(huán)境的差異抽出來運(yùn)行時通過參數(shù)動態(tài)切換。它還提供了 Actuator 模塊允許你在生產(chǎn)環(huán)境查看應(yīng)用健康狀態(tài)、指標(biāo)數(shù)據(jù)、線程狀態(tài)等信息。打包方面spring-boot-maven-plugin 插件提供了統(tǒng)一的打包能力可以把應(yīng)用打成一個可執(zhí)行 jar。這個 jar 里包含所有依賴和 SpringBoot 加載器邏輯在任何有 JDK 的機(jī)器上都能直接運(yùn)行。到這里我們可以總結(jié)一下Starter 解決了“依賴怎么管”自動配置解決了“Bean 怎么裝配”內(nèi)嵌容器解決了“應(yīng)用怎么跑”工程化能力解決了“生產(chǎn)環(huán)境怎么用”。這四件事正是 SpringBoot 替開發(fā)者做的全部核心工作。4. 自動裝配原理SpringBoot 最核心的機(jī)制第四章是整個 SpringBoot 認(rèn)知的基礎(chǔ)章節(jié)中最值得花時間去理解的部分也是面試中的高頻考點(diǎn)。自動裝配并沒有用到任何黑魔法它本質(zhì)上是一條清晰的執(zhí)行鏈路。先看主啟動類上的注解SpringBootApplication public class DemoApplication { public static void main(String[] args) { SpringApplication.run(DemoApplication.class, args); } }SpringBootApplication是一個組合注解它由三個注解復(fù)合而成SpringBootConfiguration它是Configuration的衍生注解標(biāo)記當(dāng)前類是一個配置類。EnableAutoConfiguration開啟自動裝配能力這是核心中的核心。ComponentScan默認(rèn)掃描當(dāng)前啟動類所在包及其子包下的所有 Spring 組件。自動裝配的起點(diǎn)就是EnableAutoConfiguration。它的內(nèi)部通過Import(AutoConfigurationImportSelector.class)導(dǎo)入了一個選擇器類。這個選擇器做了一件關(guān)鍵的事情讀取 classpath 下自動配置類的列表。在 SpringBoot 2.7 之前自動配置類列表放在META-INF/spring.factories文件中在 SpringBoot 2.7 及之后的版本中則調(diào)整為META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports。文件中每一行都記錄著一個自動配置類的全限定名比如RedisAutoConfiguration、DataSourceAutoConfiguration。這里真正巧妙的地方在于SpringBoot 并不會無條件加載這些配置類。每個自動配置類上都疊加了大量條件注解它們像一道道關(guān)卡運(yùn)行時動態(tài)判斷是否執(zhí)行裝配。常見的條件注解包括ConditionalOnClass檢查 classpath 中是否存在指定類。ConditionalOnMissingBean檢查容器中是否缺少指定 Bean。ConditionalOnProperty檢查配置項是否滿足條件。ConditionalOnWebApplication檢查當(dāng)前應(yīng)用是否為 Web 應(yīng)用。把這些條件注解放在一起看整個自動裝配的邏輯就清晰了。我用一個實際場景來串一遍假設(shè)你在 pom.xml 中引入了 spring-boot-starter-data-redis。啟動時SpringBoot 加載自動配置類列表遇到 RedisAutoConfiguration 后開始做條件判斷。它檢查 classpath 中是否存在 RedisTemplate、LettuceConnectionFactory 等類如果存在說明項目真的需要考慮 Redis 集成于是繼續(xù)檢查容器中是否已經(jīng)有用戶自定義的 RedisTemplate Bean。如果沒有才自動創(chuàng)建默認(rèn)的 RedisTemplate 和連接工廠。換句話說自動配置類是一份“備選裝配方案”框架拿著這份方案去對照當(dāng)前項目的 classpath 和容器狀態(tài)匹配的才執(zhí)行不匹配的直接跳過。這就像裝修公司拿到一本厚厚的菜單但只按照你實際買回來的材料來決定做什么菜。如果你想查看哪些自動配置生效了可以在配置文件中加上一行debugtrue啟動時日志會打印 Positive matches 和 Negative matches 兩大列表。Positive matches 是已經(jīng)生效的自動配置Negative matches 是因為條件不滿足而未生效的配置。出現(xiàn)自動配置不生效問題時第一件事應(yīng)該是看這兩張表而不是去猜原因。如果你明確不想讓某個自動配置生效也有對應(yīng)的排除方式。可以在啟動類注解中排除SpringBootApplication(exclude {RedisAutoConfiguration.class})也可以在配置文件中排除spring.autoconfigure.excludeorg.springframework.boot.autoconfigure.data.redis.RedisAutoConfiguration自動裝配原理的技術(shù)鏈路可以這樣歸納SpringBootApplication中的EnableAutoConfiguration通過AutoConfigurationImportSelector加載自動配置類列表然后每個自動配置類通過條件注解做按需裝配最終在容器中注冊得到系統(tǒng)所需要的 Bean。我建議你在理解這條鏈路之后再去看具體的自動配置源碼會有一種從暗箱走到明面的通透感。5. 環(huán)境準(zhǔn)備與項目初始化在寫示例之前我們先明確 SpringBoot 項目運(yùn)行的環(huán)境要求。不同 SpringBoot 版本對 JDK 的要求差異很大這是新手最常踩的坑。SpringBoot 2.x最低支持 JDK 8使用 Java 8 或 11 都很常見。SpringBoot 3.x強(qiáng)制要求 JDK 17 及以上因為 Spring Framework 6 在 JDK 17 上構(gòu)建。如果你的本機(jī)是 JDK 8去創(chuàng)建一個 SpringBoot 3.x 項目編譯階段就會直接報錯。所以創(chuàng)建項目之前一定要先確認(rèn)自己的 JDK 版本這與選擇 SpringBoot 版本是強(qiáng)綁定的。建議的前置環(huán)境JDK 8 或 JDK 17視 SpringBoot 版本而定。Maven 3.6。IDEA 或 Eclipse推薦 IDEA 社區(qū)版/旗艦版均可。不需要提前安裝 Tomcat內(nèi)嵌容器會解決。項目創(chuàng)建方式有兩種。第一種是使用 Spring Initializr 網(wǎng)頁生成項目壓縮包后導(dǎo)入 IDE第二種直接在 IDEA 中通過“New Project - Spring Initializr”創(chuàng)建。如果你在訪問 start.spring.io 時速度較慢可以使用國內(nèi)鏡像地址例如阿里云提供的 Spring Initializr 服務(wù)在 IDEA 的 Server URL 中替換即可。如果你在實際工作中已經(jīng)有一個 Maven 工程手動加入 SpringBoot 的 parent 和 starter 依賴也可以。從零學(xué)習(xí)和跑通流程最省力的是通過 Spring Initializr 生成。6. 完整示例從零跑通第一個 SpringBoot 項目我們這里用一個最小可運(yùn)行示例把整個流程走通。項目構(gòu)建工具使用 MavenSpringBoot 版本使用 3.2.5因此 JDK 需要 17。如果你的環(huán)境是 JDK 8請將 parent 版本改為 2.7.18并將 java.version 改為 8。6.1 創(chuàng)建項目在 IDEA 中新建項目選擇 Spring Initializr。Name 填 demoGroup 填 com.exampleLanguage 選擇 JavaType 選擇 MavenPackaging 選擇 JarJava 版本根據(jù)你本地環(huán)境選擇。依賴部分先只勾選 Spring Web。生成項目后目錄結(jié)構(gòu)如下demo ├── pom.xml └── src └── main ├── java │ └── com/example/demo │ ├── DemoApplication.java │ └── controller │ └── HelloController.java └── resources └── application.yml6.2 完整 pom.xml如果你沒有通過 Spring Initializr 生成也可以直接使用下面的 pom.xml 手工搭建環(huán)境?xml version1.0 encodingUTF-8? project xmlnshttp://maven.apache.org/POM/4.0.0 xmlns:xsihttp://www.w3.org/2001/XMLSchema-instance xsi:schemaLocationhttp://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd modelVersion4.0.0/modelVersion parent groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-parent/artifactId version3.2.5/version relativePath/ /parent groupIdcom.example/groupId artifactIddemo/artifactId version0.0.1-SNAPSHOT/version namedemo/name descriptionSpring Boot Demo/description properties java.version17/java.version /properties dependencies dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-web/artifactId /dependency dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-test/artifactId scopetest/scope /dependency /dependencies build plugins plugin groupIdorg.springframework.boot/groupId artifactIdspring-boot-maven-plugin/artifactId /plugin /plugins /build /project這里最關(guān)鍵的是引入了spring-boot-starter-parent作為 Maven parent。它會統(tǒng)一管理 SpringBoot 相關(guān)依賴的版本之后你在 dependencies 中寫 starter 時不需要再指定 version這個細(xì)節(jié)就是 SpringBoot 依賴管理機(jī)制在 Maven 層面的體現(xiàn)。6.3 啟動類和 Controller啟動類默認(rèn)已經(jīng)生成內(nèi)容如下package com.example.demo; import org.springframework.boot.SpringApplication; import org.springframework.boot.autoconfigure.SpringBootApplication; SpringBootApplication public class DemoApplication { public static void main(String[] args) { SpringApplication.run(DemoApplication.class, args); } }接下來創(chuàng)建第一個 Controller路徑在src/main/java/com/example/demo/controller/HelloController.javapackage com.example.demo.controller; import org.springframework.web.bind.annotation.GetMapping; import org.springframework.web.bind.annotation.RequestMapping; import org.springframework.web.bind.annotation.RestController; import java.util.HashMap; import java.util.Map; RestController RequestMapping(/api) public class HelloController { GetMapping(/hello) public MapString, String hello() { MapString, String result new HashMap(); result.put(message, Hello Spring Boot!); return result; } }RestController相當(dāng)于Controller加ResponseBody方法的返回值會直接以 JSON 形式寫出。這里返回一個 MapSpring Boot 默認(rèn)集成 Jackson會自動完成 JSON 序列化。6.4 配置文件與讀取配置在src/main/resources/application.yml中增加基礎(chǔ)配置server: port: 8080 spring: application: name: demo app: name: spring-boot-demo desc: first-springboot-project為了讓配置更工程化我用ConfigurationProperties方式讀取 app 前綴的配置。創(chuàng)建配置屬性類路徑為src/main/java/com/example/demo/config/AppProperties.javapackage com.example.demo.config; import org.springframework.boot.context.properties.ConfigurationProperties; import org.springframework.stereotype.Component; Component ConfigurationProperties(prefix app) public class AppProperties { private String name; private String desc; public String getName() { return name; } public void setName(String name) { this.name name; } public String getDesc() { return desc; } public void setDesc(String desc) { this.desc desc; } }然后修改 Controller把配置值注入并暴露接口package com.example.demo.controller; import com.example.demo.config.AppProperties; import org.springframework.web.bind.annotation.GetMapping; import org.springframework.web.bind.annotation.RequestMapping; import org.springframework.web.bind.annotation.RestController; import java.util.HashMap; import java.util.Map; RestController RequestMapping(/api) public class HelloController { private final AppProperties appProperties; public HelloController(AppProperties appProperties) { this.appProperties appProperties; } GetMapping(/hello) public MapString, String hello() { MapString, String result new HashMap(); result.put(message, Hello Spring Boot!); return result; } GetMapping(/config) public MapString, String config() { MapString, String result new HashMap(); result.put(appName, appProperties.getName()); result.put(appDesc, appProperties.getDesc()); return result; } }SpringBoot 的構(gòu)造器注入已經(jīng)非常成熟這里的 Controller 使用構(gòu)造器注入AppProperties代碼簡潔且易于測試。相比Value(${app.name})的散落寫法ConfigurationProperties把相關(guān)配置集中到一個強(qiáng)類型對象中適合配置項較多的場景這也是實際項目推薦的用法。6.5 運(yùn)行與驗證運(yùn)行方式有兩種第一種在 IDEA 中直接運(yùn)行DemoApplication的 main 方法。啟動后控制臺會出現(xiàn) Spring Boot 的啟動 Banner并打印內(nèi)嵌 Tomcat 的監(jiān)聽端口。第二種使用 Maven 命令運(yùn)行mvn spring-boot:run啟動成功后在瀏覽器訪問http://localhost:8080/api/hello預(yù)期返回{message:Hello Spring Boot!}再訪問http://localhost:8080/api/config預(yù)期返回的是 application.yml 中配置的內(nèi)容{appDesc:first-springboot-project,appName:spring-boot-demo}如果你能看到這兩個接口返回 JSON說明你的第一個 SpringBoot 項目已經(jīng)完全跑通了。這時候項目內(nèi)部發(fā)生了什么SpringBoot 發(fā)現(xiàn)你引入了 spring-boot-starter-web自動配置了內(nèi)嵌 Tomcat、Spring MVC、Jackson 等組件它掃描到啟動類包下的 Component注冊了 Controller 和配置屬性類它還根據(jù) application.yml 中的內(nèi)容綁定了配置對象。整個過程沒有任何外部 Tomcat、沒有 web.xml、沒有任何 Spring XML 文件。7. 進(jìn)階實踐多環(huán)境配置、打包與 Docker 部署項目跑通之后下一步是把工程化實踐中繞不開的幾件事搞清楚。多環(huán)境配置是真實項目的硬需求。開發(fā)、測試、生產(chǎn)三套環(huán)境不可能用同一套數(shù)據(jù)庫地址和日志級別。SpringBoot 的 profile 機(jī)制可以這樣組織在src/main/resources下創(chuàng)建三個文件application.yml 作為主配置只放公共配置spring: profiles: active: devapplication-dev.ymlserver: port: 8080 app: name: spring-boot-demo desc: dev-environmentapplication-prod.ymlserver: port: 8080 app: name: spring-boot-demo desc: prod-environment啟動時如果不加參數(shù)默認(rèn)激活 dev profile。生產(chǎn)環(huán)境啟動時可以通過命令行參數(shù)覆蓋java -jar demo-0.0.1-SNAPSHOT.jar --spring.profiles.activeprod也可以使用環(huán)境變量方式export SPRING_PROFILES_ACTIVEprod java -jar demo-0.0.1-SNAPSHOT.jarMaven 打包很簡單進(jìn)入項目根目錄執(zhí)行mvn clean package打包成功后在 target 目錄下會生成demo-0.0.1-SNAPSHOT.jar。這個 jar 是 SpringBoot 的可執(zhí)行 jar里面包含所有依賴和內(nèi)嵌 Tomcat。部署時只需要把 jar 拷貝到目標(biāo)機(jī)器保證裝有對應(yīng)版本的 JDK直接運(yùn)行即可。如果項目用 Docker 部署可以編寫如下 DockerfileFROM openjdk:17-jdk-slim LABEL authorsyour-name WORKDIR /app COPY target/demo-0.0.1-SNAPSHOT.jar /app/app.jar EXPOSE 8080 ENTRYPOINT [java, -jar, app.jar]構(gòu)建命令docker build -t springboot-demo:1.0 .運(yùn)行命令docker run -d -p 8080:8080 --name demo springboot-demo:1.0需要注意這里使用的是 JDK 17 基礎(chǔ)鏡像因為我們的 SpringBoot 版本是 3.2.5。如果你因為本機(jī)只有 JDK 8 而選擇了 SpringBoot 2.7.x那么基礎(chǔ)鏡像應(yīng)切換為openjdk:8-jdk-alpine否則鏡像運(yùn)行時同樣會出現(xiàn)版本不兼容問題。生產(chǎn)部署還有一個容易被忽略的點(diǎn)容器內(nèi) SpringBoot 的配置注入。通常不建議把數(shù)據(jù)庫密碼、密鑰等敏感配置直接寫在 application-prod.yml 里更推薦通過環(huán)境變量注入例如spring: datasource: url: ${DB_URL} username: ${DB_USERNAME} password: ${DB_PASSWORD}這樣配置文件只保留占位符真實值由容器平臺在運(yùn)行時注入減小配置泄露風(fēng)險。涉及生產(chǎn)環(huán)境變更時也建議先在測試環(huán)境用同一套鏡像驗證再逐步切換流量。8. 常見問題與排查方法SpringBoot 項目本身的啟動鏈路很短但新手在實際操作中仍然會遇到不少問題。下面的表格匯總了幾類高頻問題按“現(xiàn)象 - 原因 - 排查 - 解決”整理可以直接對照使用。問題現(xiàn)象可能原因排查方式解決方案啟動報錯 Web server failed to start提示 Port 8080 was already in use本地端口被其他進(jìn)程占用在命令行執(zhí)行l(wèi)sof -i:8080或netstat -ano | findstr 8080查看占用進(jìn)程關(guān)閉占用端口進(jìn)程或修改server.port配置為其他端口創(chuàng)建 SpringBoot 3.x 項目后編譯報錯提示無效的目標(biāo)發(fā)行版JDK 版本低于 17執(zhí)行java -version確認(rèn) JDK 版本升級到 JDK 17或?qū)?SpringBoot parent 版本降為 2.7.x從 Spring Initializr 下載或創(chuàng)建項目時長時間卡住網(wǎng)絡(luò)無法穩(wěn)定訪問 start.spring.io查看 IDEA 日志或瀏覽器下載鏈接將 Server URL 切換為阿里云 Spring Initializr 鏡像啟動后請求接口返回 404啟動類位置和 Controller 不在同一包路徑下檢查 ComponentScan 掃描范圍保持 Controller 位于啟動類的子包內(nèi)application.yml 不自動提示屬性IDE 未識別配置元數(shù)據(jù)或依賴未導(dǎo)入檢查是否引入了 spring-boot-configuration-processor引入配置處理器依賴并在 IDEA 中刷新 Maven 索引修改 application.yml 后配置沒生效應(yīng)用未重啟或 profile 未切換確認(rèn)啟動日志中 Active profile 和加載的配置文件重啟應(yīng)用指定正確的--spring.profiles.active自動配置沒有生效條件注解判斷不滿足在配置中開啟debugtrue查看 Positive/Negative matches按缺失條件補(bǔ)齊依賴或配置項Eclipse 中集成 SpringBoot 時依賴一直 downloadingMaven 倉庫下載速度慢或鏡像問題檢查 Maven 配置文件 settings.xml 中的 mirror配置阿里云 Maven 鏡像倉庫這組問題里第一類“端口被占用”和第三類“創(chuàng)建項目卡住”是使用內(nèi)嵌容器和在線初始化后的必然結(jié)果。理解它的原理后再排查就不會覺得陌生。實際上SpringBoot 的 log 輸出非常友好絕大多數(shù)啟動失敗都會明確指向啟動鏈路的具體位置。9. 最佳實踐與學(xué)習(xí)路線建議文章寫到這里SpringBoot 的核心認(rèn)知框架已經(jīng)搭建完整。最后我想分享幾條工程實踐建議這是我在實際項目中最深刻的體會。第一版本選型要先行。新項目優(yōu)先選擇當(dāng)前穩(wěn)定版本的 SpringBoot 3.x但前提是團(tuán)隊 JDK 版本已經(jīng)支持 17。如果團(tuán)隊還在維護(hù)老項目不要輕易升級大版本SpringBoot 2.x 到 3.x 的升級涉及 Jakarta EE、javax 到 jakarta 包名遷移等兼容性改動成本不比想象中低。第二不要為了“省事”一次引入太多 starter。每多一個 starter自動配置就會多一批候選裝配項雖然條件注解保證了按需裝配但依賴體積和應(yīng)用啟動復(fù)雜度也會增加。建議按真實需求引入并定期用mvn dependency:tree檢查依賴樹。第三配置盡量集中并且類型安全。散落的Value在配置項多的時候很難維護(hù)建議對業(yè)務(wù)配置使用ConfigurationProperties封裝成對象。配置項命名統(tǒng)一使用 kebab-case例如app.max-file-size。第四排除自動配置之前要三思。當(dāng)你發(fā)現(xiàn)某個自動配置的行為不符合預(yù)期時第一反應(yīng)不應(yīng)該是 exclude 它而是先確認(rèn)它的生效條件、當(dāng)前 classpath 狀態(tài)、以及是否可以通過顯式聲明一個 Bean 來覆蓋默認(rèn)行為。盲目 exclude 可能導(dǎo)致其他依賴鏈路斷裂。第五生產(chǎn)環(huán)境開啟 Actuator 時注意端點(diǎn)暴露范圍。Actuator 的 health 端點(diǎn)很有用但不要把所有端點(diǎn)都無限制暴露到公網(wǎng)。實際部署時建議通過management.endpoints.web.exposure.includehealth,info只暴露基礎(chǔ)端點(diǎn)并配合認(rèn)證機(jī)制做訪問控制。第六如果你正在準(zhǔn)備 SpringBoot 面試不要只背結(jié)論。自動裝配原理、條件注解、Starter 機(jī)制、內(nèi)嵌容器、配置加載順序、事務(wù)失效場景、循環(huán)依賴這七個方向基本覆蓋了大部分高頻考點(diǎn)但每個方向都需要能畫出鏈路、講出原因、舉出例子才算真正掌握。本文是 SpringBoot 系列的第一節(jié)核心目標(biāo)是把“它是什么、它做了什么、它是怎么做到的、怎么快速跑起來”這條主線打通。你在讀完后建議做兩件事第一按照第 5、6、7 章的內(nèi)容手寫一個最小項目并嘗試切換 profile、打包、用 Docker 運(yùn)行第二回來看第 4 章的自動裝配鏈路用 IDEA 的 debug 功能跟著 AutoConfigurationImportSelector 走一遍源碼親眼看看自動配置類是怎么被加載進(jìn)來的。等這兩步都做完了自動裝配原理對你來說就不再是面試題而是一種你已經(jīng)內(nèi)化的工程直覺。 SpringBoot是什么？一文講透自動裝配原理與快速上手
“SpringBoot 是什么很多人背了一堆注解卻仍然說不清楚它到底做了什么。”這是許多 Java 開發(fā)者學(xué)習(xí)路徑上最真實的狀態(tài)。大家用 RestController 寫接口、用 Service 寫業(yè)務(wù)、用 Autowired 注入對象覺得 SpringBoot 就是“Spring 的簡化版”可一旦被問到“自動裝配原理”“Starter 到底是什么”“為什么啟動一個項目不需要配置 Tomcat”就會陷入一種似懂非懂的尷尬。這篇文章想幫大家把這個問題徹底理清楚。我會從 SpringBoot 提出的背景、它在 Spring 生態(tài)中的真實定位、它替開發(fā)者做的具體事情入手再深入到自動裝配原理和后端項目落地。這是系列的第一節(jié)內(nèi)容偏“認(rèn)知框架”和“快速上手”目標(biāo)是讓你讀完不僅知道 SpringBoot 好用還能說清楚它為什么好用、好在哪里、核心機(jī)制是怎么設(shè)計的。1. SpringBoot 到底是什么不是“又一個新框架”很多初學(xué)者容易把 SpringBoot 誤認(rèn)為是一個和 Spring 并列的獨(dú)立框架這是第一個認(rèn)知誤區(qū)。實際上SpringBoot 并不是重寫了一套新框架而是構(gòu)建在 Spring Framework 之上的“開發(fā)基礎(chǔ)設(shè)施”。它做的事情用一句話概括就是讓 Spring 應(yīng)用可以“開箱即用”。你可以把 Spring Framework 理解為發(fā)動機(jī)。發(fā)動機(jī)很強(qiáng)大但把它裝到車上還需要變速箱、底盤、電氣系統(tǒng)、輪子等一系列配套。傳統(tǒng)模式下這些配套需要你手工組裝而 SpringBoot 直接提供了一輛“能開就走”的整車并且它沒有改動發(fā)動機(jī)本身。具體到技術(shù)層面SpringBoot 提供了幾個關(guān)鍵能力自動配置根據(jù)項目引入的依賴和 classpath 情況自動生成需要的 Bean。Starter 依賴管理把一組功能相關(guān)的依賴打包成“套餐”解決版本兼容問題。內(nèi)嵌 Servlet 容器項目無需外置 Tomcat、Jetty 即可獨(dú)立運(yùn)行。生產(chǎn)級運(yùn)維特性健康檢查、指標(biāo)采集、外部配置等能力內(nèi)置在框架中。這意味著SpringBoot 不是“替代 Spring”而是“重新組織 Spring 的使用方式”。你寫的業(yè)務(wù)代碼仍然是 Spring Bean你用的依賴仍然是 Spring 生態(tài)的組件只是裝配邏輯從“自己寫 XML”變成了“框架自動判斷”。這種模式一般被稱為“約定優(yōu)于配置”SpringBoot 把這種思想從口號變成了工程落地。2. 回到“配置地獄”沒有 SpringBoot 之前有多痛要理解 SpringBoot 的價值最好是回到它出現(xiàn)之前的時代。當(dāng)時一個典型的 Java Web 項目也就是我們常說的 SSMSpring Spring MVC MyBatis架構(gòu)從創(chuàng)建到啟動需要手工完成大量重復(fù)配置。在 web.xml 里配置 Spring 的 ContextLoaderListener 和 DispatcherServlet在 spring-mvc.xml 里開啟注解驅(qū)動、配置視圖解析器、靜態(tài)資源映射在 applicationContext.xml 里配置數(shù)據(jù)源、事務(wù)管理器、MyBatis 的 SqlSessionFactory 和 Mapper 掃描。這還只是基礎(chǔ)配置。如果項目要集成 Redis、消息隊列、定時任務(wù)對應(yīng)的配置會繼續(xù)膨脹。我舉一個很小的例子光是 Spring MVC 的基礎(chǔ)配置片段就足夠勸退新手!-- web.xml 中的核心配置片段 -- servlet servlet-namedispatcher/servlet-name servlet-classorg.springframework.web.servlet.DispatcherServlet/servlet-class init-param param-namecontextConfigLocation/param-name param-valueclasspath:spring-mvc.xml/param-value /init-param load-on-startup1/load-on-startup /servlet servlet-mapping servlet-namedispatcher/servlet-name url-pattern//url-pattern /servlet-mapping這還只是 web.xml 的冰山一角。除了配置本身還有兩個更折磨人的問題第一依賴版本需要手工維護(hù)。SSM 項目要引入 Spring、Spring MVC、MyBatis、MyBatis-Spring 等依賴每一個組件的版本都要自己確認(rèn)兼容性。遇到版本沖突時排查兩個 jar 之間的依賴關(guān)系會消耗大量時間而 Maven 的依賴樹卻只是冷冰冰的列表。第二部署鏈路很長。開發(fā)完代碼后需要打成 war 包再把 war 包放到本地安裝的 Tomcat 的 webapps 目錄下啟動 Tomcat才能看到效果。這個過程雖然只多了 3 到 5 步但每臺開發(fā)機(jī)的環(huán)境不同經(jīng)常出現(xiàn)“在同事電腦上能跑在我電腦上報錯”的問題。把這兩件事疊加起來一個普通的新項目從創(chuàng)建到能夠在瀏覽器里看到第一個頁面很多時候需要大半天。而 SpringBoot 出現(xiàn)后新項目從創(chuàng)建到啟動只要幾分鐘。這不是操作熟練度的問題而是整個使用范式被重寫了。3. SpringBoot 的四大動作它替開發(fā)者做了哪些事SpringBoot 實現(xiàn)“開箱即用”靠的是四個核心動作。把它們拆開看清楚你對 SpringBoot 的理解就會從“知道”變成“掌握”。3.1 Starter 起步依賴依賴管理從“點(diǎn)菜”變成“套餐”過去引入依賴是“點(diǎn)菜”邏輯我先決定要 Spring MVC再去決定要不要 Jackson還要考慮 JSON 序列化用哪個庫比較合適。每個決定都代表一次潛在的錯誤判斷。SpringBoot 換成了“套餐”邏輯。你只需要引入一個 starter例如 spring-boot-starter-web這個套餐里就自動包含了 Spring MVC、內(nèi)嵌 Tomcat、Jackson、Spring Boot 自動配置模塊等一組與 Web 開發(fā)相關(guān)的最佳實踐依賴。你不用關(guān)心具體版本SpringBoot 的依賴管理機(jī)制已經(jīng)把這些組件的兼容版本通過 spring-boot-dependencies 統(tǒng)一鎖定。這種設(shè)計最直接的收益是你只需要關(guān)心“我要做什么功能”而不是“我要引哪些 jar”。3.2 自動配置基于條件的智能默認(rèn)值自動配置是 SpringBoot 看起來“魔法”的部分。它的核心思路是框架根據(jù)你引入的依賴和當(dāng)前環(huán)境自動創(chuàng)建你“大概率需要”的 Bean。舉例來說當(dāng)你引入了 spring-boot-starter-web 并且 classpath 中包含 Spring MVC 相關(guān)類時SpringBoot 會悄悄幫你創(chuàng)建 DispatcherServlet、內(nèi)嵌 Tomcat、HandlerMapping、異常處理器等一系列 Web 開發(fā)必需的組件。你可能一個 Bean 都沒寫過但項目啟動后 Web 能力就已經(jīng)完整可用了。這個機(jī)制的關(guān)鍵在于“有條件”。自動配置并不是無條件地把所有 Bean 都注冊進(jìn)去而是通過條件注解逐個檢查只有滿足條件才裝配。這就保證了引入的功能越多項目越復(fù)雜SpringBoot 的自動裝配也能保持足夠的準(zhǔn)確性和靈活性。這部分邏輯我會在第 4 章詳細(xì)講。3.3 內(nèi)嵌 Servlet 容器應(yīng)用本身就是服務(wù)器SpringBoot 默認(rèn)把 Tomcat 以嵌入式方式打包進(jìn)應(yīng)用。也就是說你生成的 jar 包中不僅包含你的代碼也包含了一個可以直接運(yùn)行的 Servlet 容器。由于容器內(nèi)嵌部署方式徹底改變。過去是“應(yīng)用適配服務(wù)器”現(xiàn)在是“應(yīng)用直接運(yùn)行”。你可以直接在命令行執(zhí)行java -jar demo.jar也可以將 jar 包丟進(jìn) Docker 容器讓容器內(nèi)的 JDK 來執(zhí)行它。開發(fā)環(huán)境、測試環(huán)境、生產(chǎn)環(huán)境的差異被壓縮到最小。在 SpringBoot 中Tomcat 只是默認(rèn)選擇如果你想用 Jetty 或 Undertow只需要在依賴上切換對應(yīng)的 starter業(yè)務(wù)代碼一行都不用改。這個靈活性是傳統(tǒng)外置容器時代很難想象的事情。3.4 工程化能力配置體系、監(jiān)控與統(tǒng)一打包SpringBoot 在去掉大量 XML 配置的同時也沒有把配置能力丟掉而是換了一套更輕量的方式。它支持 application.properties 和 application.yml 兩種配置文件并提供多環(huán)境 profile 機(jī)制你可以用 application-dev.yml、application-prod.yml 把不同環(huán)境的差異抽出來運(yùn)行時通過參數(shù)動態(tài)切換。它還提供了 Actuator 模塊允許你在生產(chǎn)環(huán)境查看應(yīng)用健康狀態(tài)、指標(biāo)數(shù)據(jù)、線程狀態(tài)等信息。打包方面spring-boot-maven-plugin 插件提供了統(tǒng)一的打包能力可以把應(yīng)用打成一個可執(zhí)行 jar。這個 jar 里包含所有依賴和 SpringBoot 加載器邏輯在任何有 JDK 的機(jī)器上都能直接運(yùn)行。到這里我們可以總結(jié)一下Starter 解決了“依賴怎么管”自動配置解決了“Bean 怎么裝配”內(nèi)嵌容器解決了“應(yīng)用怎么跑”工程化能力解決了“生產(chǎn)環(huán)境怎么用”。這四件事正是 SpringBoot 替開發(fā)者做的全部核心工作。4. 自動裝配原理SpringBoot 最核心的機(jī)制第四章是整個 SpringBoot 認(rèn)知的基礎(chǔ)章節(jié)中最值得花時間去理解的部分也是面試中的高頻考點(diǎn)。自動裝配并沒有用到任何黑魔法它本質(zhì)上是一條清晰的執(zhí)行鏈路。先看主啟動類上的注解SpringBootApplication public class DemoApplication { public static void main(String[] args) { SpringApplication.run(DemoApplication.class, args); } }SpringBootApplication是一個組合注解它由三個注解復(fù)合而成SpringBootConfiguration它是Configuration的衍生注解標(biāo)記當(dāng)前類是一個配置類。EnableAutoConfiguration開啟自動裝配能力這是核心中的核心。ComponentScan默認(rèn)掃描當(dāng)前啟動類所在包及其子包下的所有 Spring 組件。自動裝配的起點(diǎn)就是EnableAutoConfiguration。它的內(nèi)部通過Import(AutoConfigurationImportSelector.class)導(dǎo)入了一個選擇器類。這個選擇器做了一件關(guān)鍵的事情讀取 classpath 下自動配置類的列表。在 SpringBoot 2.7 之前自動配置類列表放在META-INF/spring.factories文件中在 SpringBoot 2.7 及之后的版本中則調(diào)整為META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports。文件中每一行都記錄著一個自動配置類的全限定名比如RedisAutoConfiguration、DataSourceAutoConfiguration。這里真正巧妙的地方在于SpringBoot 并不會無條件加載這些配置類。每個自動配置類上都疊加了大量條件注解它們像一道道關(guān)卡運(yùn)行時動態(tài)判斷是否執(zhí)行裝配。常見的條件注解包括ConditionalOnClass檢查 classpath 中是否存在指定類。ConditionalOnMissingBean檢查容器中是否缺少指定 Bean。ConditionalOnProperty檢查配置項是否滿足條件。ConditionalOnWebApplication檢查當(dāng)前應(yīng)用是否為 Web 應(yīng)用。把這些條件注解放在一起看整個自動裝配的邏輯就清晰了。我用一個實際場景來串一遍假設(shè)你在 pom.xml 中引入了 spring-boot-starter-data-redis。啟動時SpringBoot 加載自動配置類列表遇到 RedisAutoConfiguration 后開始做條件判斷。它檢查 classpath 中是否存在 RedisTemplate、LettuceConnectionFactory 等類如果存在說明項目真的需要考慮 Redis 集成于是繼續(xù)檢查容器中是否已經(jīng)有用戶自定義的 RedisTemplate Bean。如果沒有才自動創(chuàng)建默認(rèn)的 RedisTemplate 和連接工廠。換句話說自動配置類是一份“備選裝配方案”框架拿著這份方案去對照當(dāng)前項目的 classpath 和容器狀態(tài)匹配的才執(zhí)行不匹配的直接跳過。這就像裝修公司拿到一本厚厚的菜單但只按照你實際買回來的材料來決定做什么菜。如果你想查看哪些自動配置生效了可以在配置文件中加上一行debugtrue啟動時日志會打印 Positive matches 和 Negative matches 兩大列表。Positive matches 是已經(jīng)生效的自動配置Negative matches 是因為條件不滿足而未生效的配置。出現(xiàn)自動配置不生效問題時第一件事應(yīng)該是看這兩張表而不是去猜原因。如果你明確不想讓某個自動配置生效也有對應(yīng)的排除方式。可以在啟動類注解中排除SpringBootApplication(exclude {RedisAutoConfiguration.class})也可以在配置文件中排除spring.autoconfigure.excludeorg.springframework.boot.autoconfigure.data.redis.RedisAutoConfiguration自動裝配原理的技術(shù)鏈路可以這樣歸納SpringBootApplication中的EnableAutoConfiguration通過AutoConfigurationImportSelector加載自動配置類列表然后每個自動配置類通過條件注解做按需裝配最終在容器中注冊得到系統(tǒng)所需要的 Bean。我建議你在理解這條鏈路之后再去看具體的自動配置源碼會有一種從暗箱走到明面的通透感。5. 環(huán)境準(zhǔn)備與項目初始化在寫示例之前我們先明確 SpringBoot 項目運(yùn)行的環(huán)境要求。不同 SpringBoot 版本對 JDK 的要求差異很大這是新手最常踩的坑。SpringBoot 2.x最低支持 JDK 8使用 Java 8 或 11 都很常見。SpringBoot 3.x強(qiáng)制要求 JDK 17 及以上因為 Spring Framework 6 在 JDK 17 上構(gòu)建。如果你的本機(jī)是 JDK 8去創(chuàng)建一個 SpringBoot 3.x 項目編譯階段就會直接報錯。所以創(chuàng)建項目之前一定要先確認(rèn)自己的 JDK 版本這與選擇 SpringBoot 版本是強(qiáng)綁定的。建議的前置環(huán)境JDK 8 或 JDK 17視 SpringBoot 版本而定。Maven 3.6。IDEA 或 Eclipse推薦 IDEA 社區(qū)版/旗艦版均可。不需要提前安裝 Tomcat內(nèi)嵌容器會解決。項目創(chuàng)建方式有兩種。第一種是使用 Spring Initializr 網(wǎng)頁生成項目壓縮包后導(dǎo)入 IDE第二種直接在 IDEA 中通過“New Project - Spring Initializr”創(chuàng)建。如果你在訪問 start.spring.io 時速度較慢可以使用國內(nèi)鏡像地址例如阿里云提供的 Spring Initializr 服務(wù)在 IDEA 的 Server URL 中替換即可。如果你在實際工作中已經(jīng)有一個 Maven 工程手動加入 SpringBoot 的 parent 和 starter 依賴也可以。從零學(xué)習(xí)和跑通流程最省力的是通過 Spring Initializr 生成。6. 完整示例從零跑通第一個 SpringBoot 項目我們這里用一個最小可運(yùn)行示例把整個流程走通。項目構(gòu)建工具使用 MavenSpringBoot 版本使用 3.2.5因此 JDK 需要 17。如果你的環(huán)境是 JDK 8請將 parent 版本改為 2.7.18并將 java.version 改為 8。6.1 創(chuàng)建項目在 IDEA 中新建項目選擇 Spring Initializr。Name 填 demoGroup 填 com.exampleLanguage 選擇 JavaType 選擇 MavenPackaging 選擇 JarJava 版本根據(jù)你本地環(huán)境選擇。依賴部分先只勾選 Spring Web。生成項目后目錄結(jié)構(gòu)如下demo ├── pom.xml └── src └── main ├── java │ └── com/example/demo │ ├── DemoApplication.java │ └── controller │ └── HelloController.java └── resources └── application.yml6.2 完整 pom.xml如果你沒有通過 Spring Initializr 生成也可以直接使用下面的 pom.xml 手工搭建環(huán)境?xml version1.0 encodingUTF-8? project xmlnshttp://maven.apache.org/POM/4.0.0 xmlns:xsihttp://www.w3.org/2001/XMLSchema-instance xsi:schemaLocationhttp://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd modelVersion4.0.0/modelVersion parent groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-parent/artifactId version3.2.5/version relativePath/ /parent groupIdcom.example/groupId artifactIddemo/artifactId version0.0.1-SNAPSHOT/version namedemo/name descriptionSpring Boot Demo/description properties java.version17/java.version /properties dependencies dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-web/artifactId /dependency dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-test/artifactId scopetest/scope /dependency /dependencies build plugins plugin groupIdorg.springframework.boot/groupId artifactIdspring-boot-maven-plugin/artifactId /plugin /plugins /build /project這里最關(guān)鍵的是引入了spring-boot-starter-parent作為 Maven parent。它會統(tǒng)一管理 SpringBoot 相關(guān)依賴的版本之后你在 dependencies 中寫 starter 時不需要再指定 version這個細(xì)節(jié)就是 SpringBoot 依賴管理機(jī)制在 Maven 層面的體現(xiàn)。6.3 啟動類和 Controller啟動類默認(rèn)已經(jīng)生成內(nèi)容如下package com.example.demo; import org.springframework.boot.SpringApplication; import org.springframework.boot.autoconfigure.SpringBootApplication; SpringBootApplication public class DemoApplication { public static void main(String[] args) { SpringApplication.run(DemoApplication.class, args); } }接下來創(chuàng)建第一個 Controller路徑在src/main/java/com/example/demo/controller/HelloController.javapackage com.example.demo.controller; import org.springframework.web.bind.annotation.GetMapping; import org.springframework.web.bind.annotation.RequestMapping; import org.springframework.web.bind.annotation.RestController; import java.util.HashMap; import java.util.Map; RestController RequestMapping(/api) public class HelloController { GetMapping(/hello) public MapString, String hello() { MapString, String result new HashMap(); result.put(message, Hello Spring Boot!); return result; } }RestController相當(dāng)于Controller加ResponseBody方法的返回值會直接以 JSON 形式寫出。這里返回一個 MapSpring Boot 默認(rèn)集成 Jackson會自動完成 JSON 序列化。6.4 配置文件與讀取配置在src/main/resources/application.yml中增加基礎(chǔ)配置server: port: 8080 spring: application: name: demo app: name: spring-boot-demo desc: first-springboot-project為了讓配置更工程化我用ConfigurationProperties方式讀取 app 前綴的配置。創(chuàng)建配置屬性類路徑為src/main/java/com/example/demo/config/AppProperties.javapackage com.example.demo.config; import org.springframework.boot.context.properties.ConfigurationProperties; import org.springframework.stereotype.Component; Component ConfigurationProperties(prefix app) public class AppProperties { private String name; private String desc; public String getName() { return name; } public void setName(String name) { this.name name; } public String getDesc() { return desc; } public void setDesc(String desc) { this.desc desc; } }然后修改 Controller把配置值注入并暴露接口package com.example.demo.controller; import com.example.demo.config.AppProperties; import org.springframework.web.bind.annotation.GetMapping; import org.springframework.web.bind.annotation.RequestMapping; import org.springframework.web.bind.annotation.RestController; import java.util.HashMap; import java.util.Map; RestController RequestMapping(/api) public class HelloController { private final AppProperties appProperties; public HelloController(AppProperties appProperties) { this.appProperties appProperties; } GetMapping(/hello) public MapString, String hello() { MapString, String result new HashMap(); result.put(message, Hello Spring Boot!); return result; } GetMapping(/config) public MapString, String config() { MapString, String result new HashMap(); result.put(appName, appProperties.getName()); result.put(appDesc, appProperties.getDesc()); return result; } }SpringBoot 的構(gòu)造器注入已經(jīng)非常成熟這里的 Controller 使用構(gòu)造器注入AppProperties代碼簡潔且易于測試。相比Value(${app.name})的散落寫法ConfigurationProperties把相關(guān)配置集中到一個強(qiáng)類型對象中適合配置項較多的場景這也是實際項目推薦的用法。6.5 運(yùn)行與驗證運(yùn)行方式有兩種第一種在 IDEA 中直接運(yùn)行DemoApplication的 main 方法。啟動后控制臺會出現(xiàn) Spring Boot 的啟動 Banner并打印內(nèi)嵌 Tomcat 的監(jiān)聽端口。第二種使用 Maven 命令運(yùn)行mvn spring-boot:run啟動成功后在瀏覽器訪問http://localhost:8080/api/hello預(yù)期返回{message:Hello Spring Boot!}再訪問http://localhost:8080/api/config預(yù)期返回的是 application.yml 中配置的內(nèi)容{appDesc:first-springboot-project,appName:spring-boot-demo}如果你能看到這兩個接口返回 JSON說明你的第一個 SpringBoot 項目已經(jīng)完全跑通了。這時候項目內(nèi)部發(fā)生了什么SpringBoot 發(fā)現(xiàn)你引入了 spring-boot-starter-web自動配置了內(nèi)嵌 Tomcat、Spring MVC、Jackson 等組件它掃描到啟動類包下的 Component注冊了 Controller 和配置屬性類它還根據(jù) application.yml 中的內(nèi)容綁定了配置對象。整個過程沒有任何外部 Tomcat、沒有 web.xml、沒有任何 Spring XML 文件。7. 進(jìn)階實踐多環(huán)境配置、打包與 Docker 部署項目跑通之后下一步是把工程化實踐中繞不開的幾件事搞清楚。多環(huán)境配置是真實項目的硬需求。開發(fā)、測試、生產(chǎn)三套環(huán)境不可能用同一套數(shù)據(jù)庫地址和日志級別。SpringBoot 的 profile 機(jī)制可以這樣組織在src/main/resources下創(chuàng)建三個文件application.yml 作為主配置只放公共配置spring: profiles: active: devapplication-dev.ymlserver: port: 8080 app: name: spring-boot-demo desc: dev-environmentapplication-prod.ymlserver: port: 8080 app: name: spring-boot-demo desc: prod-environment啟動時如果不加參數(shù)默認(rèn)激活 dev profile。生產(chǎn)環(huán)境啟動時可以通過命令行參數(shù)覆蓋java -jar demo-0.0.1-SNAPSHOT.jar --spring.profiles.activeprod也可以使用環(huán)境變量方式export SPRING_PROFILES_ACTIVEprod java -jar demo-0.0.1-SNAPSHOT.jarMaven 打包很簡單進(jìn)入項目根目錄執(zhí)行mvn clean package打包成功后在 target 目錄下會生成demo-0.0.1-SNAPSHOT.jar。這個 jar 是 SpringBoot 的可執(zhí)行 jar里面包含所有依賴和內(nèi)嵌 Tomcat。部署時只需要把 jar 拷貝到目標(biāo)機(jī)器保證裝有對應(yīng)版本的 JDK直接運(yùn)行即可。如果項目用 Docker 部署可以編寫如下 DockerfileFROM openjdk:17-jdk-slim LABEL authorsyour-name WORKDIR /app COPY target/demo-0.0.1-SNAPSHOT.jar /app/app.jar EXPOSE 8080 ENTRYPOINT [java, -jar, app.jar]構(gòu)建命令docker build -t springboot-demo:1.0 .運(yùn)行命令docker run -d -p 8080:8080 --name demo springboot-demo:1.0需要注意這里使用的是 JDK 17 基礎(chǔ)鏡像因為我們的 SpringBoot 版本是 3.2.5。如果你因為本機(jī)只有 JDK 8 而選擇了 SpringBoot 2.7.x那么基礎(chǔ)鏡像應(yīng)切換為openjdk:8-jdk-alpine否則鏡像運(yùn)行時同樣會出現(xiàn)版本不兼容問題。生產(chǎn)部署還有一個容易被忽略的點(diǎn)容器內(nèi) SpringBoot 的配置注入。通常不建議把數(shù)據(jù)庫密碼、密鑰等敏感配置直接寫在 application-prod.yml 里更推薦通過環(huán)境變量注入例如spring: datasource: url: ${DB_URL} username: ${DB_USERNAME} password: ${DB_PASSWORD}這樣配置文件只保留占位符真實值由容器平臺在運(yùn)行時注入減小配置泄露風(fēng)險。涉及生產(chǎn)環(huán)境變更時也建議先在測試環(huán)境用同一套鏡像驗證再逐步切換流量。8. 常見問題與排查方法SpringBoot 項目本身的啟動鏈路很短但新手在實際操作中仍然會遇到不少問題。下面的表格匯總了幾類高頻問題按“現(xiàn)象 - 原因 - 排查 - 解決”整理可以直接對照使用。問題現(xiàn)象可能原因排查方式解決方案啟動報錯 Web server failed to start提示 Port 8080 was already in use本地端口被其他進(jìn)程占用在命令行執(zhí)行l(wèi)sof -i:8080或netstat -ano | findstr 8080查看占用進(jìn)程關(guān)閉占用端口進(jìn)程或修改server.port配置為其他端口創(chuàng)建 SpringBoot 3.x 項目后編譯報錯提示無效的目標(biāo)發(fā)行版JDK 版本低于 17執(zhí)行java -version確認(rèn) JDK 版本升級到 JDK 17或?qū)?SpringBoot parent 版本降為 2.7.x從 Spring Initializr 下載或創(chuàng)建項目時長時間卡住網(wǎng)絡(luò)無法穩(wěn)定訪問 start.spring.io查看 IDEA 日志或瀏覽器下載鏈接將 Server URL 切換為阿里云 Spring Initializr 鏡像啟動后請求接口返回 404啟動類位置和 Controller 不在同一包路徑下檢查 ComponentScan 掃描范圍保持 Controller 位于啟動類的子包內(nèi)application.yml 不自動提示屬性IDE 未識別配置元數(shù)據(jù)或依賴未導(dǎo)入檢查是否引入了 spring-boot-configuration-processor引入配置處理器依賴并在 IDEA 中刷新 Maven 索引修改 application.yml 后配置沒生效應(yīng)用未重啟或 profile 未切換確認(rèn)啟動日志中 Active profile 和加載的配置文件重啟應(yīng)用指定正確的--spring.profiles.active自動配置沒有生效條件注解判斷不滿足在配置中開啟debugtrue查看 Positive/Negative matches按缺失條件補(bǔ)齊依賴或配置項Eclipse 中集成 SpringBoot 時依賴一直 downloadingMaven 倉庫下載速度慢或鏡像問題檢查 Maven 配置文件 settings.xml 中的 mirror配置阿里云 Maven 鏡像倉庫這組問題里第一類“端口被占用”和第三類“創(chuàng)建項目卡住”是使用內(nèi)嵌容器和在線初始化后的必然結(jié)果。理解它的原理后再排查就不會覺得陌生。實際上SpringBoot 的 log 輸出非常友好絕大多數(shù)啟動失敗都會明確指向啟動鏈路的具體位置。9. 最佳實踐與學(xué)習(xí)路線建議文章寫到這里SpringBoot 的核心認(rèn)知框架已經(jīng)搭建完整。最后我想分享幾條工程實踐建議這是我在實際項目中最深刻的體會。第一版本選型要先行。新項目優(yōu)先選擇當(dāng)前穩(wěn)定版本的 SpringBoot 3.x但前提是團(tuán)隊 JDK 版本已經(jīng)支持 17。如果團(tuán)隊還在維護(hù)老項目不要輕易升級大版本SpringBoot 2.x 到 3.x 的升級涉及 Jakarta EE、javax 到 jakarta 包名遷移等兼容性改動成本不比想象中低。第二不要為了“省事”一次引入太多 starter。每多一個 starter自動配置就會多一批候選裝配項雖然條件注解保證了按需裝配但依賴體積和應(yīng)用啟動復(fù)雜度也會增加。建議按真實需求引入并定期用mvn dependency:tree檢查依賴樹。第三配置盡量集中并且類型安全。散落的Value在配置項多的時候很難維護(hù)建議對業(yè)務(wù)配置使用ConfigurationProperties封裝成對象。配置項命名統(tǒng)一使用 kebab-case例如app.max-file-size。第四排除自動配置之前要三思。當(dāng)你發(fā)現(xiàn)某個自動配置的行為不符合預(yù)期時第一反應(yīng)不應(yīng)該是 exclude 它而是先確認(rèn)它的生效條件、當(dāng)前 classpath 狀態(tài)、以及是否可以通過顯式聲明一個 Bean 來覆蓋默認(rèn)行為。盲目 exclude 可能導(dǎo)致其他依賴鏈路斷裂。第五生產(chǎn)環(huán)境開啟 Actuator 時注意端點(diǎn)暴露范圍。Actuator 的 health 端點(diǎn)很有用但不要把所有端點(diǎn)都無限制暴露到公網(wǎng)。實際部署時建議通過management.endpoints.web.exposure.includehealth,info只暴露基礎(chǔ)端點(diǎn)并配合認(rèn)證機(jī)制做訪問控制。第六如果你正在準(zhǔn)備 SpringBoot 面試不要只背結(jié)論。自動裝配原理、條件注解、Starter 機(jī)制、內(nèi)嵌容器、配置加載順序、事務(wù)失效場景、循環(huán)依賴這七個方向基本覆蓋了大部分高頻考點(diǎn)但每個方向都需要能畫出鏈路、講出原因、舉出例子才算真正掌握。本文是 SpringBoot 系列的第一節(jié)核心目標(biāo)是把“它是什么、它做了什么、它是怎么做到的、怎么快速跑起來”這條主線打通。你在讀完后建議做兩件事第一按照第 5、6、7 章的內(nèi)容手寫一個最小項目并嘗試切換 profile、打包、用 Docker 運(yùn)行第二回來看第 4 章的自動裝配鏈路用 IDEA 的 debug 功能跟著 AutoConfigurationImportSelector 走一遍源碼親眼看看自動配置類是怎么被加載進(jìn)來的。等這兩步都做完了自動裝配原理對你來說就不再是面試題而是一種你已經(jīng)內(nèi)化的工程直覺。