Spring Boot 入門：從 Spring Initializr 生成項目到首次啟動

Spring Boot 极速上手：官方脚手架生成與運行驗證

Spring Boot 以「約定優於配置」聞名，官方提供 Spring Initializr 線上生成空白項目，幾分鐘即可跑通第一個服務。本文記錄從網頁填單到 IDEA 導入運行的完整流程。

一、Spring Initializr 填單指南

二、依賴選擇：Web 開發必選

在 Dependencies 搜索框輸入 Web，勾選 Spring Web（包含內嵌 Tomcat + Spring MVC + Jackson）。
常用組合：
- Spring Web + Lombok + Spring Boot DevTools（開發期熱部署）
- MySQL Driver + MyBatis / JPA（持久層）
- Spring Data Redis、Spring Cloud Starter 等按需添加

三、生成、導入與啟動

1. 點擊 GENERATE 下載 demo.zip
2. 解壓至工作目錄
3. IDEA File → Open 選中解壓目錄下的 pom.xml，選 Open as Project
4. 等待 Maven 下載依賴（右下角進度條）
5. 找到帶 @SpringBootApplication 的主類（如 DemoApplication），右鍵 Run

四、控制台輸出解讀

  .   ____          _            __ _ _
 /\\ / ___'_ __ _ _(_)_ __  __ _ \ \ \ \
( ( )\___ | '_ | '_| | '_ \/ _` | \ \ \ \
 \\/  ___)| |_)| | | | | || (_| |  ) ) ) )
  '  |____| .__|_| |_|_| |_\__, | / / / /
 =========|_|==============|___/=/_/_/_/
 :: Spring Boot ::                (v3.2.0)

2024-01-15T10:30:45.123+08:00  INFO 12345 --- [           main] c.e.demo.DemoApplication     : Starting DemoApplication using Java 17.0.9 with PID 12345
2024-01-15T10:30:45.125+08:00  INFO 12345 --- [           main] c.e.demo.DemoApplication     : No active profile set, falling back to default profiles: default
2024-01-15T10:30:46.456+08:00  INFO 12345 --- [           main] o.s.b.w.embedded.tomcat.TomcatWebServer  : Tomcat initialized with port(s): 8080 (http)
2024-01-15T10:30:46.789+08:00  INFO 12345 --- [           main] c.e.demo.DemoApplication     : Started DemoApplication in 2.345 seconds (process running for 2.876)

關鍵標誌：Tomcat initialized with port(s): 8080 (http)、Started ... in X seconds。

五、驗證服務可用

• 瀏覽器訪問 https://localhost:8080 → 預期 404（無 Controller），但說明容器已啟動
• Actuator 健康檢查（若引入 spring-boot-starter-actuator）：https://localhost:8080/actuator/health → {"status":"UP"}

六、下一步：編寫第一個 REST 接口

@RestController
@RequestMapping("/api/hello")
public class HelloController {
    @GetMapping
    public String hello(@RequestParam(defaultValue = "World") String name) {
        return "Hello, " + name + "! From Spring Boot.";
    }
}

重啟應用，訪問 https://localhost:8080/api/hello?name=Boot 即見返回。

七、常見問題速查

1. 端口被佔用：application.yml 加 server.port: 8081 或殺掉佔用進程
2. Java 版本不匹配：IDEA Project Structure → Project → SDK 與 pom.xml <java.version> 一致
3. 依賴下載失敗：配置阿里云 Maven 鏡像（settings.xml <mirror>）
4. 無主清單屬性：確認 spring-boot-maven-plugin 存在並執行 mvn package