Spring Boot

Spring Boot 是 Spring 应用的启动和默认装配体系。它把常用依赖、默认配置、内嵌服务器、配置加载、日志、健康检查等工程能力组织起来，让应用能以更少样板配置启动，但底层仍然是 Spring Framework 的 IoC、AOP、MVC 等机制。

详细位置

• 本页说明 Boot 的 Starter、自动配置、配置加载、Actuator、打包运行和排查方式。
• Spring 基础模块关系见 Spring 总览。
• Bean 装配机制见 IoC 容器。
• Web 请求链见 Spring MVC。
• 事务和方法增强见 AOP。

Boot 到底做了什么

一个 Boot 应用启动时，大致发生这些事：

1. 创建 Spring 应用上下文。
2. 读取配置文件、环境变量、命令行参数等外部配置。
3. 扫描启动类所在包及其子包下的组件。
4. 根据 classpath、配置项、已有 Bean 判断哪些自动配置生效。
5. 如果是 Web 应用，启动内嵌服务器。
6. 暴露日志、健康检查、指标等运行时观察入口。

Boot 像一套标准化开机程序。它不是替你写业务，而是让数据库、Web、JSON、校验、日志、监控这些常用部件按约定先装起来。

核心组成

组成	负责什么	直观理解
Starter	成组引入依赖	一套工具箱
自动配置	条件满足时注册默认 Bean	自动装配工
外部化配置	从文件、环境变量、命令行读取配置	应用参数面板
配置绑定	把配置变成类型安全对象	参数表转对象
Actuator	暴露健康、指标、环境、路由等端点	运行仪表盘

Starter

Starter 只负责依赖组合，不直接代表功能已经正确运行。比如引入 Web Starter，会带来 MVC、内嵌 Tomcat、JSON 处理等依赖；这些依赖进入 classpath 后，自动配置再判断是否创建对应 Bean。

常见 Starter：

Starter	带来的能力
spring-boot-starter-web	Servlet Web、Spring MVC、JSON、内嵌 Tomcat
spring-boot-starter-validation	参数校验
spring-boot-starter-jdbc	JDBC、连接池、事务基础
spring-boot-starter-data-redis	Redis 集成
spring-boot-starter-security	安全过滤器链
spring-boot-starter-actuator	健康检查和运行端点
spring-boot-starter-test	测试基础设施

加了 Starter 但功能没生效时，不要只看依赖是否存在，还要看自动配置条件是否满足。

自动配置

自动配置的本质是条件判断。Boot 会问几个问题：

• classpath 里有没有相关类。
• 配置项是否打开。
• 当前是不是 Web 应用。
• 容器里是否已经有用户自己定义的 Bean。
• 这个自动配置是否被排除。

只有条件满足，默认 Bean 才会注册。用户自己定义 Bean 后，很多默认配置会主动让位。这是 Boot 的重要原则：默认配置负责起步，显式配置负责覆盖。

排查自动配置时，优先使用：

java -jar app.jar --debug

或 Actuator 的 conditions 端点：

curl http://localhost:8080/actuator/conditions

看报告时重点关注：

• 哪些配置命中了。
• 哪些配置没命中。
• 没命中的条件是什么。
• 是否已有自定义 Bean 导致默认配置让位。

配置加载

Boot 支持从多个位置读取配置。常见来源可以按优先级粗略理解为：

1. 命令行参数。
2. 环境变量。
3. profile 专属配置。
4. 默认配置文件。
5. 代码默认值。

例如同一个端口配置，命令行参数通常会覆盖配置文件。配置排查时不要只看 application.yml，要确认运行时最终值来自哪里。

常用命令：

java -jar app.jar --spring.profiles.active=prod
java -jar app.jar --server.port=8081

配置绑定

业务配置如果超过一两个字段，应优先使用配置绑定。它把同一组配置聚合为对象，例如支付网关地址、超时时间、重试次数、业务开关。

这样做的好处：

• 配置结构清晰。
• 能设置默认值。
• 能做校验。
• 测试更方便。
• 排查时能按前缀定位。

配置绑定适合业务参数，不适合承载业务流程。配置回答“参数是什么”，业务代码回答“根据参数怎么做”。

Actuator

Actuator 是 Boot 应用的运行观察入口。它不解决业务问题，但能帮助判断应用是否活着、配置是什么、路由有哪些、自动配置为什么生效或没生效。

常用端点：

端点	用途
/actuator/health	健康检查
/actuator/metrics	指标
/actuator/env	查看环境和配置来源
/actuator/conditions	查看自动配置条件
/actuator/mappings	查看 MVC 路由

生产环境暴露 Actuator 要谨慎。env、conditions、beans 等端点可能泄露内部结构或敏感配置，应配合鉴权、网络隔离和最小暴露范围。

打包和运行

Boot 应用通常打成可执行 Jar。Maven 项目常用：

mvn clean package -DskipTests
java -jar target/order-service.jar --spring.profiles.active=prod

运行问题排查时，先确认：

• 使用的 JDK 版本是否符合项目要求。
• 当前 profile 是否正确。
• 依赖是否完整打进包里。
• 启动参数是否覆盖了配置文件。
• 端口、数据库、Redis、消息队列等外部依赖是否可访问。

Spring Boot 3 基于 Spring Framework 6，运行时要求 Java 17 或更高版本。升级到 Boot 3 时，还需要关注 Jakarta 包名迁移、第三方依赖兼容性和构建插件版本。

常见问题

加了依赖但功能没生效

检查顺序：

1. 依赖是否进入运行时 classpath。
2. 自动配置条件是否满足。
3. 必要配置项是否缺失。
4. 是否已有用户自定义 Bean 让默认配置失效。
5. 是否排除了相关自动配置。

配置值不是预期

检查顺序：

1. 当前 profile。
2. 命令行参数。
3. 环境变量。
4. 配置文件位置。
5. 配置绑定前缀和字段。
6. Actuator /actuator/env 中的最终来源。

应用启动慢

常见原因：

• 初始化阶段做远程调用。
• 启动时扫描范围过大。
• 外部依赖连接超时。
• 引入了暂时不用的 Starter。
• 启动时执行大量数据预热或迁移。

处理时先定位慢在哪里，再决定是缩小扫描、设置超时、清理依赖，还是把非关键预热移到启动后异步执行。

端口被占用

临时换端口：

java -jar app.jar --server.port=8081

如果在容器或服务器中运行，还要检查宿主机端口映射、网关转发和健康检查地址是否同步调整。

测试选择

测试目标	推荐方式
纯业务规则	普通 JUnit 单元测试
Controller 映射和响应	@WebMvcTest
配置绑定	配置绑定测试或小范围 Spring 测试
自动配置和上下文	@SpringBootTest
完整接口链路	随机端口集成测试

Boot 测试不要一律启动完整上下文。完整上下文适合验证装配，不适合替代快速业务测试。

总结

Spring Boot 的核心是约定、默认装配和运行入口。读 Boot 项目时先看 Starter，再看配置文件和 profile，再看用户自定义配置，最后用 debug 报告或 Actuator 确认自动配置结果。Boot 让项目容易启动，但生产环境仍要明确管理数据库、线程池、安全端点、日志、健康检查和外部依赖超时。