此版本仍在开发中,尚未被视为稳定版本。如需最新稳定版本,请使用 Spring Boot 4.0.4!spring-doc.cadn.net.cn

构建系统

强烈建议您选择一个支持依赖管理且能够使用发布到 Maven 中央仓库的构件的构建系统。 我们建议您选择 Maven 或 Gradle。 虽然可以让 Spring Boot 与其他构建系统(例如 Ant)协同工作,但这些构建系统并未得到良好支持。spring-doc.cadn.net.cn

依赖管理

每个 Spring Boot 版本均提供一份经精心挑选的、其所支持的依赖项列表。 实际上,您无需在构建配置中为这些依赖项指定版本号,因为 Spring Boot 会为您统一管理。 当您升级 Spring Boot 自身时,这些依赖项也会以一致的方式随之升级。spring-doc.cadn.net.cn

如果需要,您仍然可以指定版本并覆盖 Spring Boot 的推荐配置。

精选列表包含了所有可与 Spring Boot 一起使用的 Spring 模块,以及一份精挑细选的第三方库列表。 该列表以标准物料清单(BOM)形式提供,可用于 MavenGradlespring-doc.cadn.net.cn

每个 Spring Boot 版本都关联着一个基础版本的 Spring 框架。 我们强烈建议您不要指定该版本。

Maven

如需了解如何在 Maven 中使用 Spring Boot,请参阅 Spring Boot 的 Maven 插件文档:spring-doc.cadn.net.cn

Gradle

如需了解如何在 Gradle 中使用 Spring Boot,请参阅 Spring Boot 的 Gradle 插件文档:spring-doc.cadn.net.cn

Ant(构建工具)

可以使用 Apache Ant + Ivy 构建 Spring Boot 项目。 spring-boot-antlib “AntLib” 模块也可用于帮助 Ant 创建可执行的 JAR 文件。spring-doc.cadn.net.cn

要声明依赖项,典型的 ivy.xml 文件如下例所示:spring-doc.cadn.net.cn

<ivy-module version="2.0">
	<info organisation="org.springframework.boot" module="spring-boot-sample-ant" />
	<configurations>
		<conf name="compile" description="everything needed to compile this module" />
		<conf name="runtime" extends="compile" description="everything needed to run this module" />
	</configurations>
	<dependencies>
		<dependency org="org.springframework.boot" name="spring-boot-starter"
			rev="${spring-boot.version}" conf="compile" />
	</dependencies>
</ivy-module>

一个典型的 build.xml 如以下示例所示:spring-doc.cadn.net.cn

<project
	xmlns:ivy="antlib:org.apache.ivy.ant"
	xmlns:spring-boot="antlib:org.springframework.boot.ant"
	name="myapp" default="build">

	<property name="spring-boot.version" value="3.5.13-SNAPSHOT" />

	<target name="resolve" description="--> retrieve dependencies with ivy">
		<ivy:retrieve pattern="lib/[conf]/[artifact]-[type]-[revision].[ext]" />
	</target>

	<target name="classpaths" depends="resolve">
		<path id="compile.classpath">
			<fileset dir="lib/compile" includes="*.jar" />
		</path>
	</target>

	<target name="init" depends="classpaths">
		<mkdir dir="build/classes" />
	</target>

	<target name="compile" depends="init" description="compile">
		<javac srcdir="src/main/java" destdir="build/classes" classpathref="compile.classpath" />
	</target>

	<target name="build" depends="compile">
		<spring-boot:exejar destfile="build/myapp.jar" classes="build/classes">
			<spring-boot:lib>
				<fileset dir="lib/runtime" />
			</spring-boot:lib>
		</spring-boot:exejar>
	</target>
</project>
如果您不想使用 spring-boot-antlib 模块,请参阅“操作指南”中的不使用 spring-boot-antlib 从 Ant 构建可执行归档文件一节。

Starters

Starters(Starters)是一组便捷的依赖描述符,您可以将其包含在应用程序中。 您无需再费力搜索示例代码或大量复制粘贴依赖描述符,即可一站式获取所需的所有 Spring 及相关技术。 例如,如果您希望开始使用 Spring 和 JPA 进行数据库访问,请在项目中引入 spring-boot-starter-data-jpa 依赖。spring-doc.cadn.net.cn

这些Starters(starters)包含了大量依赖项,可帮助您快速启动并运行项目,同时提供一套一致且受支持的托管传递依赖项。spring-doc.cadn.net.cn

名字中有什么

所有官方起步依赖均遵循相似的命名模式:spring-boot-starter-*,其中*表示特定类型的应用程序。 这种命名结构旨在帮助您在需要查找起步依赖时更加便捷。 许多集成开发环境(IDE)中的 Maven 集成功能支持按名称搜索依赖项。 例如,安装了适当的 Eclipse 或 Spring Tools 插件后,您可在 POM 编辑器中按下ctrl-space键,并输入“spring-boot-starter”以获取完整列表。spring-doc.cadn.net.cn

创建您自己的 Starter一节所述,第三方 Starter 的命名不应以 spring-boot 开头,因为该前缀已保留给官方 Spring Boot 构件使用。 相反,第三方 Starter 通常以项目名称开头。 例如,一个名为 thirdpartyproject 的第三方 Starter 项目,通常应命名为 thirdpartyproject-spring-boot-starterspring-doc.cadn.net.cn

以下应用程序Starters由 Spring Boot 在 org.springframework.boot 分组下提供:spring-doc.cadn.net.cn

表 1. Spring Boot 应用程序Starters
名称 描述

spring-boot-starterspring-doc.cadn.net.cn

核心Starters,包含自动配置支持、日志记录和 YAML。spring-doc.cadn.net.cn

spring-boot-starter-activemqspring-doc.cadn.net.cn

使用 Apache ActiveMQ 的 JMS 消息传递Startersspring-doc.cadn.net.cn

spring-boot-starter-amqpspring-doc.cadn.net.cn

用于使用 Spring AMQP 和 RabbitMQ 的Startersspring-doc.cadn.net.cn

spring-boot-starter-aopspring-doc.cadn.net.cn

用于 Spring AOP 和 AspectJ 的面向切面编程(AOP)Startersspring-doc.cadn.net.cn

spring-boot-starter-artemisspring-doc.cadn.net.cn

使用 Apache Artemis 的 JMS 消息传递Startersspring-doc.cadn.net.cn

spring-boot-starter-batchspring-doc.cadn.net.cn

用于使用 Spring Batch 的Startersspring-doc.cadn.net.cn

spring-boot-starter-cachespring-doc.cadn.net.cn

用于使用 Spring 框架缓存支持的Startersspring-doc.cadn.net.cn

spring-boot-starter-data-cassandraspring-doc.cadn.net.cn

用于使用 Cassandra 分布式数据库和 Spring Data Cassandra 的Startersspring-doc.cadn.net.cn

spring-boot-starter-data-cassandra-reactivespring-doc.cadn.net.cn

用于使用 Cassandra 分布式数据库和 Spring Data Cassandra Reactive 的Startersspring-doc.cadn.net.cn

spring-boot-starter-data-couchbasespring-doc.cadn.net.cn

用于使用 Couchbase 面向文档的数据库及 Spring Data Couchbase 的Startersspring-doc.cadn.net.cn

spring-boot-starter-data-couchbase-reactivespring-doc.cadn.net.cn

用于使用 Couchbase 面向文档的数据库以及 Spring Data Couchbase Reactive 的Startersspring-doc.cadn.net.cn

spring-boot-starter-data-elasticsearchspring-doc.cadn.net.cn

用于使用 Elasticsearch 搜索与分析引擎以及 Spring Data Elasticsearch 的Startersspring-doc.cadn.net.cn

spring-boot-starter-data-jdbcspring-doc.cadn.net.cn

用于使用 Spring Data JDBC 的Startersspring-doc.cadn.net.cn

spring-boot-starter-data-jpaspring-doc.cadn.net.cn

用于将 Spring Data JPA 与 Hibernate 一起使用的Startersspring-doc.cadn.net.cn

spring-boot-starter-data-ldapspring-doc.cadn.net.cn

用于使用 Spring Data LDAP 的Startersspring-doc.cadn.net.cn

spring-boot-starter-data-mongodbspring-doc.cadn.net.cn

用于使用 MongoDB 面向文档数据库及 Spring Data MongoDB 的Startersspring-doc.cadn.net.cn

spring-boot-starter-data-mongodb-reactivespring-doc.cadn.net.cn

用于使用 MongoDB 面向文档数据库及 Spring Data MongoDB Reactive 的Startersspring-doc.cadn.net.cn

spring-boot-starter-data-neo4jspring-doc.cadn.net.cn

用于使用 Neo4j 图数据库和 Spring Data Neo4j 的Startersspring-doc.cadn.net.cn

spring-boot-starter-data-r2dbcspring-doc.cadn.net.cn

用于使用 Spring Data R2DBC 的Startersspring-doc.cadn.net.cn

spring-boot-starter-data-redisspring-doc.cadn.net.cn

用于通过 Spring Data Redis 和 Lettuce 客户端使用 Redis 键值数据存储的Startersspring-doc.cadn.net.cn

spring-boot-starter-data-redis-reactivespring-doc.cadn.net.cn

用于在 Spring Data Redis 响应式编程中结合 Lettuce 客户端使用 Redis 键值数据存储的Startersspring-doc.cadn.net.cn

spring-boot-starter-data-restspring-doc.cadn.net.cn

使用 Spring Data REST 和 Spring MVC 通过 REST 暴露 Spring Data 仓库的Startersspring-doc.cadn.net.cn

spring-boot-starter-freemarkerspring-doc.cadn.net.cn

使用 FreeMarker 视图构建 MVC Web 应用程序的Startersspring-doc.cadn.net.cn

spring-boot-starter-graphqlspring-doc.cadn.net.cn

用于使用 Spring GraphQL 构建 GraphQL 应用程序的Startersspring-doc.cadn.net.cn

spring-boot-starter-groovy-templatesspring-doc.cadn.net.cn

使用 Groovy 模板视图构建 MVC Web 应用程序的Startersspring-doc.cadn.net.cn

spring-boot-starter-hateoasspring-doc.cadn.net.cn

用于使用 Spring MVC 和 Spring HATEOAS 构建基于超媒体的 RESTful Web 应用程序的Startersspring-doc.cadn.net.cn

spring-boot-starter-integrationspring-doc.cadn.net.cn

用于使用 Spring Integration 的Startersspring-doc.cadn.net.cn

spring-boot-starter-jdbcspring-doc.cadn.net.cn

使用 HikariCP 连接池进行 JDBC 开发的Startersspring-doc.cadn.net.cn

spring-boot-starter-jerseyspring-doc.cadn.net.cn

用于基于 JAX-RS 和 Jersey 构建 RESTful Web 应用程序的Starters。是 spring-boot-starter-web 的替代方案。spring-doc.cadn.net.cn

spring-boot-starter-jooqspring-doc.cadn.net.cn

用于通过 JDBC 访问 SQL 数据库的 jOOQ Starters。可替代 spring-boot-starter-data-jpaspring-boot-starter-jdbcspring-doc.cadn.net.cn

spring-boot-starter-jsonspring-doc.cadn.net.cn

用于读写 JSON 的Startersspring-doc.cadn.net.cn

spring-boot-starter-mailspring-doc.cadn.net.cn

用于使用 Java Mail 和 Spring 框架邮件发送支持的Startersspring-doc.cadn.net.cn

spring-boot-starter-mustachespring-doc.cadn.net.cn

用于使用 Mustache 视图构建 Web 应用程序的Startersspring-doc.cadn.net.cn

spring-boot-starter-oauth2-authorization-serverspring-doc.cadn.net.cn

用于使用 Spring Authorization Server 功能的Startersspring-doc.cadn.net.cn

spring-boot-starter-oauth2-clientspring-doc.cadn.net.cn

用于使用 Spring Security 的 OAuth2/OpenID Connect 客户端功能的Startersspring-doc.cadn.net.cn

spring-boot-starter-oauth2-resource-serverspring-doc.cadn.net.cn

用于使用 Spring Security 的 OAuth2 资源服务器功能的Startersspring-doc.cadn.net.cn

spring-boot-starter-pulsarspring-doc.cadn.net.cn

用于 Apache Pulsar 的 Spring Startersspring-doc.cadn.net.cn

spring-boot-starter-pulsar-reactivespring-doc.cadn.net.cn

用于在 Spring 中使用 Apache Pulsar Reactive 的Startersspring-doc.cadn.net.cn

spring-boot-starter-quartzspring-doc.cadn.net.cn

用于使用 Quartz 调度器的Startersspring-doc.cadn.net.cn

spring-boot-starter-rsocketspring-doc.cadn.net.cn

用于构建 RSocket 客户端和服务器的Startersspring-doc.cadn.net.cn

spring-boot-starter-securityspring-doc.cadn.net.cn

用于使用 Spring Security 的Startersspring-doc.cadn.net.cn

spring-boot-starter-testspring-doc.cadn.net.cn

用于使用 JUnit Jupiter、Hamcrest 和 Mockito 等库测试 Spring Boot 应用程序的Startersspring-doc.cadn.net.cn

spring-boot-starter-thymeleafspring-doc.cadn.net.cn

使用 Thymeleaf 视图构建 MVC Web 应用程序的Startersspring-doc.cadn.net.cn

spring-boot-starter-validationspring-doc.cadn.net.cn

使用 Hibernate Validator 进行 Java Bean 校验的Startersspring-doc.cadn.net.cn

spring-boot-starter-webspring-doc.cadn.net.cn

用于构建 Web 应用(包括 RESTful 应用)的Starters,基于 Spring MVC。默认使用 Tomcat 作为嵌入式容器。spring-doc.cadn.net.cn

spring-boot-starter-web-servicesspring-doc.cadn.net.cn

用于使用 Spring Web 服务的Startersspring-doc.cadn.net.cn

spring-boot-starter-webfluxspring-doc.cadn.net.cn

用于构建基于 Spring 框架响应式 Web 支持的 WebFlux 应用程序的Startersspring-doc.cadn.net.cn

spring-boot-starter-websocketspring-doc.cadn.net.cn

用于构建 WebSocket 应用程序的Starters,基于 Spring Framework 的 MVC WebSocket 支持spring-doc.cadn.net.cn

除了应用程序Starters外,以下Starters可用于添加生产就绪功能:spring-doc.cadn.net.cn

表 2. Spring Boot 生产就绪Starters
名称 描述

spring-boot-starter-actuatorspring-doc.cadn.net.cn

用于使用 Spring Boot Actuator 的Starters,该组件提供生产就绪的功能,帮助您监控和管理应用程序spring-doc.cadn.net.cn

最后,Spring Boot 还包含以下 Starter,如果您希望排除或替换特定的技术组件,可使用它们:spring-doc.cadn.net.cn

表 3. Spring Boot 技术Starters
名称 描述

spring-boot-starter-jettyspring-doc.cadn.net.cn

用于将 Jetty 作为嵌入式 Servlet 容器的Starters。是 spring-boot-starter-tomcat 的替代方案。spring-doc.cadn.net.cn

spring-boot-starter-log4j2spring-doc.cadn.net.cn

用于使用 Log4j2 进行日志记录的Starters。是 spring-boot-starter-logging 的替代方案。spring-doc.cadn.net.cn

spring-boot-starter-loggingspring-doc.cadn.net.cn

使用 Logback 进行日志记录的Starters。默认日志记录Startersspring-doc.cadn.net.cn

spring-boot-starter-reactor-nettyspring-doc.cadn.net.cn

用于将 Reactor Netty 作为嵌入式响应式 HTTP 服务器的Starters。spring-doc.cadn.net.cn

spring-boot-starter-tomcatspring-doc.cadn.net.cn

用于将 Tomcat 作为嵌入式 Servlet 容器的Starters。由 spring-boot-starter-web 使用的默认 Servlet 容器Starters。spring-doc.cadn.net.cn

spring-boot-starter-undertowspring-doc.cadn.net.cn

用于将 Undertow 作为嵌入式 Servlet 容器的Starters。是 spring-boot-starter-tomcat 的替代方案。spring-doc.cadn.net.cn

如需了解如何替换技术组件,请参阅更换Web服务器日志系统的相关操作指南。spring-doc.cadn.net.cn

有关更多由社区贡献的Starters列表,请参阅 GitHub 上 spring-boot-starters 模块中的 README 文件