小菜鸟

Spring Boot 定制嵌入式 Servlet 容器详解：配置修改与容器替换实战

Spring Boot 内置了 Tomcat（默认）、Jetty、Undertow 三种主流 Servlet 容器，无需外置服务器即可通过 java -jar 直接启动应用。实际开发中，常需根据需求 “修改容器配置”（如端口、编码）或 “替换容器”（如用 Jetty 替代 Tomcat）。从 “容器配置修改（两种方式）→ 容器替换（Tomcat 转 Jetty/Undertow）→ 底层原理” 三个维度，系统讲解嵌入式 Servlet 容器的定制方法，帮你灵活掌控应用部署环境。

嵌入式 Servlet 容器简介

Spring Boot 嵌入式容器的核心价值是 “简化部署”—— 无需手动安装、配置外置服务器（如 Tomcat），应用打包为 JAR 包后可独立运行。三种内置容器的特点对比如下：

默认情况下，引入 spring-boot-starter-web 会自动依赖 Tomcat 容器，无需额外配置。

修改嵌入式 Servlet 容器配置

Spring Boot 提供两种方式修改容器配置（如端口、编码、连接超时），分别适用于 “简单配置” 和 “复杂定制” 场景。

方式一：配置文件修改（推荐，简单场景）

通过 application.properties 或 application.yml 直接配置 server 前缀的属性，Spring Boot 会自动将配置映射到容器（底层通过 ServerProperties 类实现）。

1. 核心配置属性（常用）

2. 配置示例（YML 格式）

Spring Boot 扩展 Spring MVC 详解：保留自动配置与完全自定义配置指南

Spring Boot 对 Spring MVC 提供了完善的自动配置（如默认的 DispatcherServlet、视图解析器、静态资源映射），可满足大部分场景需求。但实际开发中，常需自定义 MVC 特性（如添加拦截器、调整静态资源路径、自定义消息转换器）。从 “自动配置基础→扩展配置（保留自动配置）→完全自定义（抛弃自动配置）→底层原理” 四个维度，系统讲解 Spring Boot 扩展 Spring MVC 的实现方式与底层逻辑，帮你灵活控制 MVC 配置。

Spring Boot 对 Spring MVC 的自动配置回顾

在学习 “扩展” 前，需先明确 Spring Boot 为 Spring MVC 提供的默认自动配置（核心由 WebMvcAutoConfiguration 类实现），避免重复配置或配置冲突：

扩展 Spring MVC：保留自动配置（推荐）

大部分场景下，无需完全替换自动配置，只需在其基础上补充自定义逻辑（如添加拦截器、调整静态资源）。Spring Boot 提供 WebMvcConfigurer 接口实现这一需求，且 Spring Boot 2.x+ 推荐直接实现该接口（替代过时的 WebMvcConfigurerAdapter）。

1. 核心接口：WebMvcConfigurer（Spring Boot 2.x+ 推荐）

WebMvcConfigurer 是 Spring MVC 提供的 “全局配置接口”，包含一系列 default 方法（Java 8+ 特性），开发者可按需重写，无需实现所有方法。常用方法及作用如下：

Spring Boot 多环境配置详解：从文件分离到 Bean 按需加载

在实际开发中，项目通常需要适配多种环境（如开发、测试、生产），不同环境的配置（如端口、数据库连接、第三方服务地址）往往不同。Spring Boot 提供了灵活的多环境配置方案，支持通过 “多配置文件分离” 或 “单 YML 多文档块” 实现环境隔离，并通过 @Profile 注解实现 Bean 的按需加载。从 “多环境配置方式→激活策略→Bean 环境隔离→实战最佳实践” 四个维度，系统讲解 Spring Boot 多环境配置的实现逻辑与实用技巧。

多环境配置的核心思想

Spring Boot 多环境配置的核心是 “环境标识（Profile）+ 配置隔离”：

1. 环境标识：用 dev（开发）、test（测试）、prod（生产）等标识不同环境；
2. 配置隔离：为每个环境单独维护配置（或在同一文件中用文档块隔离），避免配置混杂；
3. 按需激活：启动时指定要激活的环境，Spring Boot 自动加载对应配置，无需修改代码。

多环境配置的两种核心方式

Spring Boot 支持两种主流的多环境配置方式，分别适用于 “配置项较多” 和 “配置项较少” 的场景。

方式一：多配置文件分离（推荐，配置项较多时）

通过创建多个以 application-{profile}.properties/yml 命名的配置文件，为每个环境单独维护配置，默认配置文件（application.properties/yml）负责激活环境。

1. 配置文件命名规则

Spring Boot 配置文件详解：类型、加载顺序、自定义配置与实战指南

Spring Boot 的核心优势之一是 “约定大于配置”，但实际开发中仍需通过配置文件自定义参数（如端口、数据库连接、第三方服务密钥等）。Spring Boot 支持多种配置文件格式和加载策略，从 “配置文件类型→加载顺序→外部配置引入→自定义配置→bootstrap 与 application 区别→配置优先级” 六个维度，系统讲解 Spring Boot 配置文件的使用方法与底层逻辑，帮你彻底掌握配置管理技巧。

Spring Boot 配置文件的两种核心类型

Spring Boot 支持两种主流配置文件格式：application.properties（键值对格式）和 application.yml（YAML 格式），二者功能完全一致，仅语法风格不同，可根据团队习惯选择。

1. 格式对比与语法规则

（1）application.properties（传统键值对格式）

• 语法：采用 key=value 结构，层级关系通过 . 分隔；
• 优点：语法简单，兼容性好（所有 Spring 版本支持）；
• 缺点：层级嵌套时冗余（需重复写前缀）。

示例：

1
2
3
4
5
6
7
8
9
10
11
12

# 服务器配置
server.port=8080
server.servlet.context-path=/demo

# 数据库配置
spring.datasource.url=jdbc:mysql://localhost:3306/test
spring.datasource.username=root
spring.datasource.password=123456

# 自定义配置
custom.name=Spring Boot
custom.version=2.7.10

（2）application.yml（YAML 缩进格式，推荐）

• 语法：采用 “缩进 + 冒号” 表示层级关系，键值对用 key: value（冒号后需加空格）；
• 优点：层级清晰，冗余少，支持列表、对象等复杂结构；
• 缺点：对缩进敏感（必须用空格，不能用 Tab），低版本 Spring 需额外依赖（Spring Boot 1.2+ 已内置支持）。

示例（与上述 properties 配置等价）：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18

# 服务器配置（层级通过缩进体现）
server:
  port: 8080
  servlet:
    context-path: /demo

# 数据库配置
spring:
  datasource:
    url: jdbc:mysql://localhost:3306/test
    username: root
    password: 123456

# 自定义配置（支持对象结构）
custom:
  name: Spring Boot
  version: 2.7.10
  features: [自动配置, 嵌入式容器, Starter依赖] # 列表格式

2. 两种格式的优先级

若同一目录下同时存在 application.properties 和 application.yml：

• 优先级：application.properties > application.yml（相同配置项，properties 会覆盖 yml）；
• 建议：项目中统一使用一种格式（推荐 yml，层级更清晰），避免混合使用导致配置冲突。

Spring Boot 配置文件的默认加载顺序

Spring Boot 启动时会自动扫描4 个默认位置的 application.properties/yml 文件，按 “优先级从高到低” 加载，高优先级配置会覆盖低优先级配置（若配置项重复），且所有位置的配置文件会合并生效（非重复项叠加）。

Spring Boot 主程序深度解析：@SpringBootApplication 与自动配置原理

Spring Boot 主程序是应用的 “入口点”，而 @SpringBootApplication 注解则是主程序的 “灵魂”—— 它并非单一注解，而是由多个核心注解复合而成，封装了 Spring Boot 自动配置、组件扫描、配置类声明的核心逻辑。从 “@SpringBootApplication 注解拆解→各子注解底层原理→自动配置流程→配置报告解读” 四个维度，彻底讲透 Spring Boot 主程序的工作机制，帮你理解 “约定大于配置” 的底层实现。

Spring Boot 主程序的核心结构

一个标准的 Spring Boot 主程序由 “主类” 和 “@SpringBootApplication 注解” 组成，主类的 main 方法通过 SpringApplication.run() 启动应用，示例如下：

1
2
3
4
5
6
7
8

// 主程序类：@SpringBootApplication 标注为入口，main 方法启动应用
@SpringBootApplication
public class DemoApplication {
    public static void main(String[] args) {
        // 启动 Spring Boot 应用，初始化 Spring 容器
        SpringApplication.run(DemoApplication.class, args);
    }
}

从源码可知，@SpringBootApplication 是复合注解，本质是三个核心注解的组合：