Spring Boot 3.3.0-SNAPSHOT Reference Guide

• 语言: 英语
• 格式: .pdf
• 来源: docs.spring.io

摘要

Spring Boot 3.3.0-SNAPSHOT参考指南介绍了如何创建独立、生产级的Spring应用。其核心目标包括：提供更快速且广泛可用的入门体验；提供开箱即用的默认配置，同时在需求偏离默认值时能快速调整；提供嵌入式服务器、安全、指标、健康检查和外部化配置等通用非功能性特性；不生成代码且无需XML配置。系统要求Java 17至Java 21，以及Spring Framework 6.1.5或以上。支持Maven 3.6.3或以上和Gradle 7.x（7.5或以上）及8.x。支持Tomcat 10.1等嵌入式Servlet容器。文档还涵盖了从早期版本升级的方法，包括使用spring-boot-properties-migrator模块进行属性迁移。此外，提供了多种Starter依赖，用于简化不同技术栈的集成。

AI总结

Spring Boot 3.3.0-SNAPSHOT 是一个用于快速构建生产级 Spring 应用的框架。其核心目标是：提供极速入门体验、坚持默认配置但允许灵活调整、内置嵌入式服务器、安全、监控等非功能性特性，且无需代码生成或 XML 配置。

**系统要求**：需要 Java 17（兼容至 Java 21）、Spring Framework 6.1.5 或更高版本，以及 Maven 3.6.3+ 或 Gradle 7.5+/8.x。支持的嵌入式 Servlet 容器包括 Tomcat 10.1（Servlet 6.0）。

**文档结构**：文档提供了从零开始的入门教程、版本升级指南、开发与打包最佳实践，以及核心功能详解（如外部化配置、Profiles 等）。

**入门流程**：可通过 `java -jar` 命令直接运行构建好的 JAR 包（如 `build/libs/myproject-0.0.1-SNAPSHOT.jar`），按 `Ctrl+C` 退出。

**版本升级**：
- 从 1.x 升级需查阅项目 Wiki 的迁移指南。
- 升级到新特性版本时，可引入 `spring-boot-properties-migrator` 依赖以自动分析并临时迁移属性，但迁移完成后需移除该依赖。
- CLI 升级可通过包管理器或手动更新 PATH 环境变量完成。

**代码结构建议**：避免使用“默认包”（无包声明），推荐使用反向域名（如 `com.example.project`）作为包名，以防止 `@ComponentScan` 等注解扫描时出现问题。

**Starter 组件**：文档列出了大量官方 Starter（如 `spring-boot-starter-web`、`spring-boot-starter-data-jpa` 等）及其版本号（均为 3.3.0-SNAPSHOT）。此外，还提供了用于替换特定技术组件的“技术 Starter”，例如用 `spring-boot-starter-jetty` 替代默认的 Tomcat，或用 `spring-boot-starter-log4j2` 替代默认的 Logback 日志。