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

与 Actuator 集成

如果存在 META-INF/build-info.properties 文件，Spring Boot Actuator 会显示与构建相关的信息。 build-info 目标会生成这样一个文件，其中包含项目的坐标和构建时间。 它还允许你添加任意数量的额外属性，如下例所示：spring-doc.cadn.net.cn

<project>
	<modelVersion>4.0.0</modelVersion>
	<artifactId>build-info</artifactId>
	<build>
		<plugins>
			<plugin>
				<groupId>org.springframework.boot</groupId>
				<artifactId>spring-boot-maven-plugin</artifactId>
				<executions>
					<execution>
						<goals>
							<goal>build-info</goal>
						</goals>
						<configuration>
							<additionalProperties>
								<encoding.source>UTF-8</encoding.source>
								<encoding.reporting>UTF-8</encoding.reporting>
								<java.version>${java.version}</java.version>
							</additionalProperties>
						</configuration>
					</execution>
				</executions>
			</plugin>
		</plugins>
	</build>
</project>

此配置将在预期位置生成一个 build-info.properties 文件，并包含三个额外的键。spring-doc.cadn.net.cn

java.version 应该是项目中可用的一个常规属性。 它将按照您预期的方式进行插值。

spring-boot:build-info

org.springframework.boot:spring-boot-maven-plugin:3.5.13-SNAPSHOTspring-doc.cadn.net.cn

根据当前 build-info.properties 的内容生成一个 MavenProject 文件。spring-doc.cadn.net.cn

可选参数

姓名 类型 默认

additionalPropertiesspring-doc.cadn.net.cn

Mapspring-doc.cadn.net.cn

excludeInfoPropertiesspring-doc.cadn.net.cn

Listspring-doc.cadn.net.cn

outputFilespring-doc.cadn.net.cn

Filespring-doc.cadn.net.cn

${project.build.outputDirectory}/META-INF/build-info.propertiesspring-doc.cadn.net.cn

跳过spring-doc.cadn.net.cn

booleanspring-doc.cadn.net.cn

falsespring-doc.cadn.net.cn

时间spring-doc.cadn.net.cn

Stringspring-doc.cadn.net.cn

${project.build.outputTimestamp}spring-doc.cadn.net.cn

参数详情

additionalProperties

要存储在 build-info.properties 文件中的附加属性。每个条目在生成的 build. 文件中都会以 build-info.properties 作为前缀。spring-doc.cadn.net.cn

姓名spring-doc.cadn.net.cn

additionalPropertiesspring-doc.cadn.net.cn

类型spring-doc.cadn.net.cn

java.util.Mapspring-doc.cadn.net.cn

默认值spring-doc.cadn.net.cn

用户属性spring-doc.cadn.net.cn

Sincespring-doc.cadn.net.cn

excludeInfoProperties

应从 build-info.properties 文件中排除的属性。可用于排除标准的 group、artifact、name、version 或 time 属性，以及 additionalProperties 中的项目。spring-doc.cadn.net.cn

姓名spring-doc.cadn.net.cn

excludeInfoPropertiesspring-doc.cadn.net.cn

类型spring-doc.cadn.net.cn

java.util.Listspring-doc.cadn.net.cn

默认值spring-doc.cadn.net.cn

用户属性spring-doc.cadn.net.cn

Sincespring-doc.cadn.net.cn

outputFile

生成的 build-info.properties 文件的位置。spring-doc.cadn.net.cn

姓名spring-doc.cadn.net.cn

outputFilespring-doc.cadn.net.cn

类型spring-doc.cadn.net.cn

java.io.Filespring-doc.cadn.net.cn

默认值spring-doc.cadn.net.cn

${project.build.outputDirectory}/META-INF/build-info.propertiesspring-doc.cadn.net.cn

用户属性spring-doc.cadn.net.cn

Sincespring-doc.cadn.net.cn

skip

跳过执行。spring-doc.cadn.net.cn

姓名spring-doc.cadn.net.cn

skipspring-doc.cadn.net.cn

类型spring-doc.cadn.net.cn

booleanspring-doc.cadn.net.cn

默认值spring-doc.cadn.net.cn

falsespring-doc.cadn.net.cn

用户属性spring-doc.cadn.net.cn

spring-boot.build-info.skipspring-doc.cadn.net.cn

Sincespring-doc.cadn.net.cn

3.1.0spring-doc.cadn.net.cn

time

用于 build.time 属性的值，其格式适用于 Instant#parse(CharSequence)。默认使用 project.build.outputTimestamp；如果该值未设置，则使用 session.request.startTime。若要完全禁用 build.time 属性，请使用 'off' 或将其添加到 excludeInfoProperties 中。spring-doc.cadn.net.cn

姓名spring-doc.cadn.net.cn

timespring-doc.cadn.net.cn

类型spring-doc.cadn.net.cn

java.lang.Stringspring-doc.cadn.net.cn

默认值spring-doc.cadn.net.cn

${project.build.outputTimestamp}spring-doc.cadn.net.cn

用户属性spring-doc.cadn.net.cn

Sincespring-doc.cadn.net.cn

2.2.0spring-doc.cadn.net.cn