Spring Boot 微框架深度解讀：從零構建生產級應用

Spring Boot 作為 Spring 生態系的「意見化」框架，以「約定優於配置」重新定義了 Java 企業級開發體驗。本文從核心理念切入，手把手帶你從零構建一個可部署的 Spring Boot Web 應用。

核心設計哲學

• 起步依賴：spring-boot-starter-* 聚合常用依賴，解決版本衝突
• 自動配置：@EnableAutoConfiguration 根據類路徑自動裝配 Bean
• 內嵌容器：內建 Tomcat/Jetty/Undertow，打包為可執行 JAR
• 生產就緒：Actuator 提供健康檢查、指標、配置外部化等運維能力

專案結構規範

src/
├── main/
│   ├── java/
│   │   └── com/example/
│   │       ├── Application.java          # 啟動類
│   │       ├── config/                   # 配置類
│   │       ├── controller/               # 控制層
│   │       ├── service/                  # 業務層
│   │       ├── repository/               # 資料層
│   │       └── entity/                   # 實體類
│   └── resources/
│       ├── application.yml               # 主配置
│       ├── application-dev.yml           # 開發環境
│       ├── application-prod.yml          # 生產環境
│       └── static/templates/             # 靜態資源/模板
└── test/                                 # 測試代碼

Maven 核心配置

<parent>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-parent</artifactId>
    <version>3.2.0</version>
    <relativePath/>
</parent>

<properties>
    <java.version>17</java.version>
    <maven.compiler.source>17</maven.compiler.source>
    <maven.compiler.target>17</maven.compiler.target>
</properties>

<dependencies>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-actuator</artifactId>
    </dependency>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-test</artifactId>
        <scope>test</scope>
    </dependency>
    <!-- 熱部署 -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-devtools</artifactId>
        <optional>true</optional>
    </dependency>
</dependencies>

<build>
    <plugins>
        <plugin>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-maven-plugin</artifactId>
        </plugin>
    </plugins>
</build>

啟動類與嵌入式容器客製化

@SpringBootApplication
@EnableAsync
public class Application implements WebServerFactoryCustomizer<ConfigurableServletWebServerFactory> {

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

    @Override
    public void customize(ConfigurableServletWebServerFactory factory) {
        factory.setPort(8087);                    // 自定義端口
        factory.setContextPath("/api");           // 上下文路徑
        factory.setSessionTimeout(Duration.ofMinutes(30));
    }
}

REST 控制器範例

# application-prod.yml
server:
  port: 80
  servlet:
    context-path: /
spring:
  profiles:
    active: prod
  datasource:
    url: jdbc:mysql://prod-db:3306/app?useSSL=false
    hikari:
      maximum-pool-size: 50