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

使用插件

Maven 用户可以继承自 spring-boot-starter-parent 项目以获得合理的默认配置。 父项目提供以下功能:spring-doc.cadn.net.cn

由于 application.propertiesapplication.yml 文件接受 Spring 风格的占位符(${…​}),Maven 过滤已更改为使用 @..@ 占位符。 (您可以通过设置名为 resource.delimiter 的 Maven 属性来覆盖此行为。)

spring-boot-starter-parent 会设置 maven.compiler.release 属性,从而限制 --add-exports--add-reads--patch-module 选项(如果它们修改系统模块)。 如果您需要使用这些选项,请取消设置 maven.compiler.releasespring-doc.cadn.net.cn

<maven.compiler.release></maven.compiler.release>

然后配置源选项和目标选项:spring-doc.cadn.net.cn

<maven.compiler.source>${java.version}</maven.compiler.source>
<maven.compiler.target>${java.version}</maven.compiler.target>

继承 Starter Parent POM

要将您的项目配置为继承自 spring-boot-starter-parent,请按如下方式设置 parentspring-doc.cadn.net.cn

<!-- Inherit defaults from Spring Boot -->
<parent>
	<groupId>org.springframework.boot</groupId>
	<artifactId>spring-boot-starter-parent</artifactId>
	<version>4.1.0-M3</version>
</parent>
你应该只需在此依赖项上指定Spring Boot的版本号。 如果你导入了其他starter,可以安全地省略版本号。

通过该设置,您还可以通过在自己的项目中覆盖属性来单独覆盖依赖项。 例如,要使用不同版本的 SLF4J 库和 Spring Data 发布列车,您需要将以下内容添加到您的 pom.xml 中:spring-doc.cadn.net.cn

<properties>
	<slf4j.version>1.7.30</slf4j.version>
	<spring-data-bom.version>2024.1.10</spring-data-bom.version>
</properties>

浏览 Spring Boot 参考文档中的 依赖版本属性 部分,以获取完整的依赖版本属性列表。spring-doc.cadn.net.cn

每个 Spring Boot 版本都是针对一组特定的第三方依赖项进行设计和测试的。 覆盖版本可能会导致兼容性问题,应谨慎操作。

不使用父 POM 使用 Spring Boot

您可能有一些原因而不从 spring-boot-starter-parent POM 继承。 您可能需要使用自己公司的标准父 POM,或者您可能更倾向于显式声明所有 Maven 配置。spring-doc.cadn.net.cn

如果您不想使用 spring-boot-starter-parent,仍然可以通过使用 import 作用域的依赖来保留依赖管理(但不包括插件管理)的好处,如下所示:spring-doc.cadn.net.cn

<dependencyManagement>
	<dependencies>
		<dependency>
			<!-- Import dependency management from Spring Boot -->
			<groupId>org.springframework.boot</groupId>
			<artifactId>spring-boot-dependencies</artifactId>
			<version>4.1.0-M3</version>
			<type>pom</type>
			<scope>import</scope>
		</dependency>
	</dependencies>
</dependencyManagement>

如上所述,前面的示例设置不允许您通过使用属性来覆盖单个依赖项。 要达到相同的结果,您需要在项目中的 dependencyManagement 部分、且在 spring-boot-dependencies 条目之前添加条目。 例如,要使用不同版本的 SLF4J 库和 Spring Data 发布列车,您可以将以下元素添加到您的 pom.xml 中:spring-doc.cadn.net.cn

<dependencyManagement>
	<dependencies>
		<!-- Override SLF4J provided by Spring Boot -->
		<dependency>
			<groupId>org.slf4j</groupId>
			<artifactId>slf4j-api</artifactId>
			<version>1.7.30</version>
		</dependency>
		<!-- Override Spring Data release train provided by Spring Boot -->
		<dependency>
			<groupId>org.springframework.data</groupId>
			<artifactId>spring-data-bom</artifactId>
			<version>2024.1.10</version>
			<type>pom</type>
			<scope>import</scope>
		</dependency>
		<dependency>
			<groupId>org.springframework.boot</groupId>
			<artifactId>spring-boot-dependencies</artifactId>
			<version>4.1.0-M3</version>
			<type>pom</type>
			<scope>import</scope>
		</dependency>
	</dependencies>
</dependencyManagement>

在命令行上覆盖设置

该插件提供了一系列以 spring-boot 开头的用户属性,以便您从命令行自定义配置。spring-doc.cadn.net.cn

例如,您可以调整在运行应用程序时启用的配置文件,如下所示:spring-doc.cadn.net.cn

$ mvn spring-boot:run -Dspring-boot.run.profiles=dev,local

如果您希望既提供默认值,又允许在命令行中覆盖该值,则应结合使用用户提供的项目属性和 MOJO 配置。spring-doc.cadn.net.cn

<project>
	<properties>
		<app.profiles>local,dev</app.profiles>
	</properties>
	<build>
		<plugins>
			<plugin>
				<groupId>org.springframework.boot</groupId>
				<artifactId>spring-boot-maven-plugin</artifactId>
				<configuration>
					<profiles>${app.profiles}</profiles>
				</configuration>
			</plugin>
		</plugins>
	</build>
</project>

上述配置确保默认启用 localdev。 现在已公开一个专用属性,也可以通过命令行覆盖该属性:spring-doc.cadn.net.cn

$ mvn spring-boot:run -Dapp.profiles=test