通用应用程序属性

可以在 application.properties 文件、application.yaml 文件中,或者作为命令行开关来指定各种属性。本附录提供了常见的 Spring Boot 属性列表以及引用了使用这些属性的底层类。

Spring Boot 提供了各种转换机制和高级值格式化功能。请务必回顾 属性转换部分
属性贡献可能来自类路径上的额外 jar 文件,因此你不应将此视为详尽列表。此外,你还可以定义自己的属性。

Actuator 属性

名称 描述 默认值

management.appoptics.metrics.export.api-token

AppOptics API 令牌。

management.appoptics.metrics.export.batch-size

对于此后端,每次请求使用的测量值数量。如果发现更多测量值,则会发出多个请求。

500

management.appoptics.metrics.export.connect-timeout

对此后端请求的连接超时时间。

5s

management.appoptics.metrics.export.enabled

是否启用将指标导出到此后端。

true

management.appoptics.metrics.export.floor-times

是否发送一个向下取整的时间,当从多个主机发送测量值以便在给定的时间边界对齐它们时很有用。

false

management.appoptics.metrics.export.host-tag

将指标发送到 AppOptics 时映射到 "@host" 的标签。

instance

management.appoptics.metrics.export.read-timeout

对此后端请求的读取超时时间。

10s

management.appoptics.metrics.export.step

要使用的步长(即报告频率)。

1m

management.appoptics.metrics.export.uri

用于发送指标的 URI。

https://api.appoptics.com/v1/measurements

management.atlas.metrics.export.batch-size

对于此后端,每次请求使用的测量值数量。如果发现更多测量值,则会发出多个请求。

10000

management.atlas.metrics.export.config-refresh-frequency

从 LWC 服务刷新配置设置的频率。

10s

management.atlas.metrics.export.config-time-to-live

LWC 服务订阅的存活时间。

150s

management.atlas.metrics.export.config-uri

用于 Atlas LWC 端点检索当前订阅的 URI。

http://localhost:7101/lwc/api/v1/expressions/local-dev

management.atlas.metrics.export.connect-timeout

对此后端请求的连接超时时间。

1s

management.atlas.metrics.export.enabled

是否启用将指标导出到此后端。

true

management.atlas.metrics.export.eval-uri

用于 Atlas LWC 端点评估订阅数据的 URI。

http://localhost:7101/lwc/api/v1/evaluate

management.atlas.metrics.export.lwc-enabled

是否启用流式传输到 Atlas LWC。

false

management.atlas.metrics.export.lwc-ignore-publish-step

是否忽略与 Atlas 发布具有相同步长的表达式进行流式传输。用于将发布到 Atlas 的数据也从后端发送到流式传输的情况。

true

management.atlas.metrics.export.lwc-step

用于流式传输到 Atlas LWC 的步长(报告频率)。这是获取按需数据流支持的最高分辨率。它必须小于或等于 management.metrics.export.atlas.step,并且 management.metrics.export.atlas.step 应该是此值的偶数倍。

5s

management.atlas.metrics.export.meter-time-to-live

对于没有任何活动的 meters 的存活时间。在此期限后,meter 将被视为过期且不会被报告。

15m

management.atlas.metrics.export.num-threads

用于指标发布调度程序的线程数。

4

management.atlas.metrics.export.read-timeout

对此后端请求的读取超时时间。

10s

management.atlas.metrics.export.step

要使用的步长(即报告频率)。

1m

management.atlas.metrics.export.uri

Atlas 服务器的 URI。

http://localhost:7101/api/v1/publish

management.auditevents.enabled

是否启用审计事件的存储。

true

management.cloudfoundry.enabled

是否启用扩展的 Cloud Foundry actuator 端点。

true

management.cloudfoundry.skip-ssl-validation

是否跳过 Cloud Foundry actuator 端点安全调用的 SSL 验证。

false

management.datadog.metrics.export.api-key

Datadog API 密钥。

management.datadog.metrics.export.application-key

Datadog 应用程序密钥。非严格要求,但通过将 meter 描述、类型和基本单位发送到 Datadog 可以改善 Datadog 体验。

management.datadog.metrics.export.batch-size

对于此后端,每次请求使用的测量值数量。如果发现更多测量值,则会发出多个请求。

10000

management.datadog.metrics.export.connect-timeout

对此后端请求的连接超时时间。

1s

management.datadog.metrics.export.descriptions

是否将描述元数据发布到 Datadog。关闭此项可最小化发送的元数据量。

true

management.datadog.metrics.export.enabled

是否启用将指标导出到此后端。

true

management.datadog.metrics.export.host-tag

将指标发送到 Datadog 时映射到 "host" 的标签。

instance

management.datadog.metrics.export.read-timeout

对此后端请求的读取超时时间。

10s

management.datadog.metrics.export.step

要使用的步长(即报告频率)。

1m

management.datadog.metrics.export.uri

用于发送指标的 URI。如果你需要将指标发布到非美国地区的 Datadog 站点,或通过内部代理路由到 Datadog,请设置此项。

https://api.datadoghq.com

management.defaults.metrics.export.enabled

是否启用默认的指标导出器。

true

management.dynatrace.metrics.export.api-token

Dynatrace 身份验证令牌。

management.dynatrace.metrics.export.batch-size

对于此后端,每次请求使用的测量值数量。如果发现更多测量值,则会发出多个请求。

10000

management.dynatrace.metrics.export.connect-timeout

对此后端请求的连接超时时间。

1s

management.dynatrace.metrics.export.enabled

是否启用将指标导出到此后端。

true

management.dynatrace.metrics.export.read-timeout

对此后端请求的读取超时时间。

10s

management.dynatrace.metrics.export.step

要使用的步长(即报告频率)。

1m

management.dynatrace.metrics.export.uri

用于发送指标的 URI。应用于 SaaS、自管理实例或通过内部代理路由。

management.dynatrace.metrics.export.v1.device-id

将指标导出到 Dynatrace 的自定义设备的 ID。

management.dynatrace.metrics.export.v1.group

导出指标的分组。用于在 Dynatrace UI 中指定自定义设备组名称。

management.dynatrace.metrics.export.v1.technology-type

导出指标的技术类型。用于在 Dynatrace UI 中将指标归入一个逻辑技术名称下。

java

management.dynatrace.metrics.export.v2.default-dimensions.*

以键值对形式添加到所有指标的默认维度。如果 Micrometer 标签使用相同的键,则会被覆盖。

management.dynatrace.metrics.export.v2.enrich-with-dynatrace-metadata

是否启用 Dynatrace 元数据导出。

true

management.dynatrace.metrics.export.v2.export-meter-metadata

是否将 meter 元数据(单位和描述)导出到 Dynatrace 后端。

true

management.dynatrace.metrics.export.v2.metric-key-prefix

添加到所有导出指标的前缀字符串。

management.dynatrace.metrics.export.v2.use-dynatrace-summary-instruments

是否回退到内置的 micrometer Timer 和 DistributionSummary 工具。

true

management.elastic.metrics.export.api-key-credentials

Base64 编码的凭证字符串。与 user-name 和 password 互斥。

management.elastic.metrics.export.auto-create-index

如果索引不存在,是否自动创建索引。

true

management.elastic.metrics.export.batch-size

对于此后端,每次请求使用的测量值数量。如果发现更多测量值,则会发出多个请求。

10000

management.elastic.metrics.export.connect-timeout

对此后端请求的连接超时时间。

1s

management.elastic.metrics.export.enable-source

自动创建索引时,是否在默认索引模板中启用 _source。

false

management.elastic.metrics.export.enabled

是否启用将指标导出到此后端。

true

management.elastic.metrics.export.host

导出指标的目标主机。

http://localhost:9200

management.elastic.metrics.export.index

导出指标的目标索引。

micrometer-metrics

management.elastic.metrics.export.index-date-format

用于滚动索引的索引日期格式。附加到索引名称后。

yyyy-MM

management.elastic.metrics.export.index-date-separator

用于将索引名称与滚动索引使用的日期格式分隔开的前缀。

-

management.elastic.metrics.export.password

Elastic 服务器的登录密码。与 api-key-credentials 互斥。

management.elastic.metrics.export.pipeline

摄取管道名称。默认情况下,事件不会被预处理。

management.elastic.metrics.export.read-timeout

对此后端请求的读取超时时间。

10s

management.elastic.metrics.export.step

要使用的步长(即报告频率)。

1m

management.elastic.metrics.export.timestamp-field-name

时间戳字段的名称。

@timestamp

management.elastic.metrics.export.user-name

Elastic 服务器的登录用户。与 api-key-credentials 互斥。

management.endpoint.auditevents.access

auditevents 端点允许的访问级别。

unrestricted

management.endpoint.auditevents.cache.time-to-live

响应可缓存的最大时间。

0ms

management.endpoint.beans.access

beans 端点允许的访问级别。

unrestricted

management.endpoint.beans.cache.time-to-live

响应可缓存的最大时间。

0ms

management.endpoint.caches.access

caches 端点允许的访问级别。

unrestricted

management.endpoint.caches.cache.time-to-live

响应可缓存的最大时间。

0ms

management.endpoint.conditions.access

conditions 端点允许的访问级别。

unrestricted

management.endpoint.conditions.cache.time-to-live

响应可缓存的最大时间。

0ms

management.endpoint.configprops.access

configprops 端点允许的访问级别。

unrestricted

management.endpoint.configprops.cache.time-to-live

响应可缓存的最大时间。

0ms

management.endpoint.configprops.roles

用于确定用户是否被授权显示未清理值的角色。为空时,所有已认证用户都被授权。

management.endpoint.configprops.show-values

何时显示未清理的值。

never

management.endpoint.env.access

env 端点允许的访问级别。

unrestricted

management.endpoint.env.cache.time-to-live

响应可缓存的最大时间。

0ms

management.endpoint.env.roles

用于确定用户是否被授权显示未清理值的角色。为空时,所有已认证用户都被授权。

management.endpoint.env.show-values

何时显示未清理的值。

never

management.endpoint.flyway.access

flyway 端点允许的访问级别。

unrestricted

management.endpoint.flyway.cache.time-to-live

响应可缓存的最大时间。

0ms

management.endpoint.health.access

health 端点允许的访问级别。

unrestricted

management.endpoint.health.cache.time-to-live

响应可缓存的最大时间。

0ms

management.endpoint.health.group.*

Health 端点分组。

management.endpoint.health.logging.slow-indicator-threshold

慢速健康指标达到此阈值后将记录警告。

10s

management.endpoint.health.probes.add-additional-paths

是否在主服务器端口上提供 liveness 和 readiness 健康分组。

false

management.endpoint.health.probes.enabled

是否启用 liveness 和 readiness 探针。

false

management.endpoint.health.roles

用于确定用户是否被授权显示详细信息的角色。为空时,所有已认证用户都被授权。

management.endpoint.health.show-components

何时显示组件。如果未指定,将使用 'show-details' 设置。

management.endpoint.health.show-details

何时显示完整的健康详情。

never

management.endpoint.health.status.http-mapping.*

健康状态到 HTTP 状态码的映射。默认情况下,已注册的健康状态会映射到合理的默认值(例如,UP 映射到 200)。

management.endpoint.health.status.order

按严重程度排序的健康状态列表。

[DOWN, OUT_OF_SERVICE, UP, UNKNOWN]

management.endpoint.health.validate-group-membership

是否在启动时验证健康组的成员资格。如果一个组包含或排除不存在的健康贡献者,则验证失败。

true

management.endpoint.heapdump.access

heapdump 端点允许的访问级别。

unrestricted

management.endpoint.heapdump.cache.time-to-live

响应可缓存的最大时间。

0ms

management.endpoint.httpexchanges.access

httpexchanges 端点允许的访问级别。

unrestricted

management.endpoint.httpexchanges.cache.time-to-live

响应可缓存的最大时间。

0ms

management.endpoint.info.access

info 端点允许的访问级别。

unrestricted

management.endpoint.info.cache.time-to-live

响应可缓存的最大时间。

0ms

management.endpoint.integrationgraph.access

integrationgraph 端点允许的访问级别。

unrestricted

management.endpoint.integrationgraph.cache.time-to-live

响应可缓存的最大时间。

0ms

management.endpoint.liquibase.access

liquibase 端点允许的访问级别。

unrestricted

management.endpoint.liquibase.cache.time-to-live

响应可缓存的最大时间。

0ms

management.endpoint.logfile.access

logfile 端点允许的访问级别。

unrestricted

management.endpoint.logfile.cache.time-to-live

响应可缓存的最大时间。

0ms

management.endpoint.logfile.external-file

要访问的外部日志文件。如果日志文件是通过输出重定向而不是由日志系统本身写入的,则可以使用此选项。

management.endpoint.loggers.access

loggers 端点允许的访问级别。

unrestricted

management.endpoint.loggers.cache.time-to-live

响应可缓存的最大时间。

0ms

management.endpoint.mappings.access

mappings 端点允许的访问级别。

unrestricted

management.endpoint.mappings.cache.time-to-live

响应可缓存的最大时间。

0ms

management.endpoint.metrics.access

metrics 端点允许的访问级别。

unrestricted

management.endpoint.metrics.cache.time-to-live

响应可缓存的最大时间。

0ms

management.endpoint.prometheus.access

prometheus 端点允许的访问级别。

unrestricted

management.endpoint.quartz.access

quartz 端点允许的访问级别。

unrestricted

management.endpoint.quartz.cache.time-to-live

响应可缓存的最大时间。

0ms

management.endpoint.quartz.roles

用于确定用户是否有权查看未净化的作业或触发器值的角色。为空时,所有已认证的用户都有权访问。

management.endpoint.quartz.show-values

何时显示未净化的作业或触发器值。

never

management.endpoint.sbom.access

sbom 端点允许的访问级别。

unrestricted

management.endpoint.sbom.additional.*

附加的 SBOM。

management.endpoint.sbom.application.location

SBOM 的位置。如果为 null,则将自动检测位置。

management.endpoint.sbom.application.media-type

SBOM 的媒体类型。如果为 null,则将自动检测媒体类型。

management.endpoint.sbom.cache.time-to-live

响应可缓存的最大时间。

0ms

management.endpoint.scheduledtasks.access

scheduledtasks 端点允许的访问级别。

unrestricted

management.endpoint.scheduledtasks.cache.time-to-live

响应可缓存的最大时间。

0ms

management.endpoint.sessions.access

sessions 端点允许的访问级别。

unrestricted

management.endpoint.shutdown.access

shutdown 端点允许的访问级别。

management.endpoint.startup.access

startup 端点允许的访问级别。

unrestricted

management.endpoint.startup.cache.time-to-live

响应可缓存的最大时间。

0ms

management.endpoint.threaddump.access

threaddump 端点允许的访问级别。

unrestricted

management.endpoint.threaddump.cache.time-to-live

响应可缓存的最大时间。

0ms

management.endpoints.access.default

所有端点的默认访问级别。

management.endpoints.access.max-permitted

允许的最大端点访问级别。限制了端点各自的访问级别 (management.endpoint..access) 和默认访问级别 (management.endpoints.access.default)。

unrestricted

management.endpoints.jackson.isolated-object-mapper

是否使用隔离的对象映射器来序列化端点 JSON。

true

management.endpoints.jmx.domain

端点 JMX 域名。如果设置了 'spring.jmx.default-domain',则回退到该值。

org.springframework.boot

management.endpoints.jmx.exposure.exclude

应排除的端点 ID,或 '*' 表示所有。

management.endpoints.jmx.exposure.include

应包含的端点 ID,或 '*' 表示所有。

health

management.endpoints.jmx.static-names

要附加到表示端点的 MBean 的所有 ObjectNames 的附加静态属性。

management.endpoints.migrate-legacy-ids

是否透明地迁移旧的端点 ID。

false

management.endpoints.web.base-path

Web 端点的基本路径。当管理服务器共享主服务器端口时,相对于 servlet 上下文路径 (server.servlet.context-path) 或 WebFlux 基本路径 (spring.webflux.base-path)。当配置了单独的管理服务器端口 (management.server.port) 时,相对于管理服务器基本路径 (management.server.base-path)。

/actuator

management.endpoints.web.cors.allow-credentials

是否支持凭证。未设置时,不支持凭证。

management.endpoints.web.cors.allowed-headers

请求中允许的头列表。'*' 允许所有头。

management.endpoints.web.cors.allowed-methods

允许的方法列表。'*' 允许所有方法。未设置时,默认为 GET。

management.endpoints.web.cors.allowed-origin-patterns

允许的来源模式列表。与只支持 '*' 的允许来源不同,来源模式更灵活(例如 'https://*.example.com'),并且可以在允许凭证时使用。未设置允许来源模式或允许来源时,CORS 支持将禁用。

management.endpoints.web.cors.allowed-origins

允许的来源列表。'*' 允许所有来源。允许凭证时,不能使用 '*',应转而配置来源模式。未设置允许来源或允许来源模式时,CORS 支持将禁用。

management.endpoints.web.cors.exposed-headers

响应中要包含的头列表。

management.endpoints.web.cors.max-age

预检请求的响应可以被客户端缓存多久。如果未指定持续时间后缀,则使用秒为单位。

1800s

management.endpoints.web.discovery.enabled

是否启用发现页面。

true

management.endpoints.web.exposure.exclude

应排除的端点 ID,或 '*' 表示所有。

management.endpoints.web.exposure.include

应包含的端点 ID,或 '*' 表示所有。

[health]

management.endpoints.web.path-mapping.*

端点 ID 与应暴露它们的路径之间的映射。

management.ganglia.metrics.export.addressing-mode

UDP 地址模式,可以是单播或多播。

multicast

management.ganglia.metrics.export.duration-units

用于报告持续时间的基本时间单位。

milliseconds

management.ganglia.metrics.export.enabled

是否启用将指标导出到 Ganglia。

true

management.ganglia.metrics.export.host

接收导出指标的 Ganglia 服务器主机。

localhost

management.ganglia.metrics.export.port

接收导出指标的 Ganglia 服务器端口。

8649

management.ganglia.metrics.export.step

要使用的步长(即报告频率)。

1m

management.ganglia.metrics.export.time-to-live

指标在 Ganglia 上的存活时间。将多播 Time-To-Live 设置为主机之间跳数(路由器数)加一。

1

management.graphite.metrics.export.duration-units

用于报告持续时间的基本时间单位。

milliseconds

management.graphite.metrics.export.enabled

是否启用将指标导出到 Graphite。

true

management.graphite.metrics.export.graphite-tags-enabled

是否使用 Graphite 标签,而不是分层命名约定。除非设置了 'tagsAsPrefix',否则默认启用。

management.graphite.metrics.export.host

接收导出指标的 Graphite 服务器主机。

localhost

management.graphite.metrics.export.port

接收导出指标的 Graphite 服务器端口。

2004

management.graphite.metrics.export.protocol

将数据发送到 Graphite 时使用的协议。

pickled

management.graphite.metrics.export.rate-units

用于报告速率的基本时间单位。

seconds

management.graphite.metrics.export.step

要使用的步长(即报告频率)。

1m

management.graphite.metrics.export.tags-as-prefix

对于分层命名约定,将指定的标签键转换为指标前缀的一部分。如果 'graphiteTagsEnabled' 为 true,则忽略此设置。

[]

management.health.cassandra.enabled

是否启用 Cassandra 健康检查。

true

management.health.couchbase.enabled

是否启用 Couchbase 健康检查。

true

management.health.db.enabled

是否启用数据库健康检查。

true

management.health.db.ignore-routing-data-sources

在创建数据库健康指示器时是否忽略 AbstractRoutingDataSources。

false

management.health.defaults.enabled

是否启用默认健康指示器。

true

management.health.diskspace.enabled

是否启用磁盘空间健康检查。

true

management.health.diskspace.path

用于计算可用磁盘空间的路径。

management.health.diskspace.threshold

应有的最小磁盘空间。

10MB

management.health.elasticsearch.enabled

是否启用 Elasticsearch 健康检查。

true

management.health.influxdb.enabled

是否启用 InfluxDB 健康检查。

true

management.health.jms.enabled

是否启用 JMS 健康检查。

true

management.health.ldap.enabled

是否启用 LDAP 健康检查。

true

management.health.livenessstate.enabled

是否启用活跃性状态健康检查。

false

management.health.mail.enabled

是否启用 Mail 健康检查。

true

management.health.mongo.enabled

是否启用 MongoDB 健康检查。

true

management.health.neo4j.enabled

是否启用 Neo4j 健康检查。

true

management.health.ping.enabled

是否启用 ping 健康检查。

true

management.health.rabbit.enabled

是否启用 RabbitMQ 健康检查。

true

management.health.readinessstate.enabled

是否启用就绪性状态健康检查。

false

management.health.redis.enabled

是否启用 Redis 健康检查。

true

management.health.ssl.certificate-validity-warning-threshold

如果 SSL 证书在此阈值定义的时间范围内将失效,则应触发警告。

14d

management.health.ssl.enabled

是否启用 SSL 证书健康检查。

true

management.httpexchanges.recording.enabled

是否启用 HTTP 请求-响应交换记录。

true

management.httpexchanges.recording.include

交换记录中要包含的项目。默认包括请求头(不包括 Authorization 和 Cookie)、响应头(不包括 Set-Cookie)以及所用时间。

[request-headers, response-headers, errors]

management.humio.metrics.export.api-token

Humio API 令牌。

management.humio.metrics.export.batch-size

对于此后端,每次请求使用的测量值数量。如果发现更多测量值,则会发出多个请求。

10000

management.humio.metrics.export.connect-timeout

对此后端请求的连接超时时间。

5s

management.humio.metrics.export.enabled

是否启用将指标导出到此后端。

true

management.humio.metrics.export.read-timeout

对此后端请求的读取超时时间。

10s

management.humio.metrics.export.step

要使用的步长(即报告频率)。

1m

management.humio.metrics.export.tags.*

描述指标存储数据源的 Humio 标签。Humio 标签与 Micrometer 的标签是不同的概念。Micrometer 的标签用于沿维度边界划分指标。

management.humio.metrics.export.uri

发送指标的 URI。如果您需要通过内部代理将指标发布到 Humio,可以使用此选项定义代理的位置。

https://cloud.humio.com

management.influx.metrics.export.api-version

要使用的 InfluxDB API 版本。如果未配置组织,则默认为 'v1'。如果配置了组织,则默认为 'v2'。

management.influx.metrics.export.auto-create-db

在尝试发布指标之前,如果 Influx 数据库不存在,是否创建它。仅限 InfluxDB v1。

true

management.influx.metrics.export.batch-size

对于此后端,每次请求使用的测量值数量。如果发现更多测量值,则会发出多个请求。

10000

management.influx.metrics.export.bucket

指标的 Bucket。可以使用 Bucket 名称或 ID。如果未设置,则默认为 db 属性的值。仅限 InfluxDB v2。

management.influx.metrics.export.compressed

是否对发布到 Influx 的指标批次启用 GZIP 压缩。

true

management.influx.metrics.export.connect-timeout

对此后端请求的连接超时时间。

1s

management.influx.metrics.export.consistency

每个点写入的一致性。

one

management.influx.metrics.export.db

发送指标的数据库。仅限 InfluxDB v1。

mydb

management.influx.metrics.export.enabled

是否启用将指标导出到此后端。

true

management.influx.metrics.export.org

写入指标的组织。仅限 InfluxDB v2。

management.influx.metrics.export.password

Influx 服务器的登录密码。仅限 InfluxDB v1。

management.influx.metrics.export.read-timeout

对此后端请求的读取超时时间。

10s

management.influx.metrics.export.retention-duration

Influx 应在当前数据库中保留数据的时间段。例如 7d,有关持续时间格式的更多详细信息,请查阅 Influx 文档。仅限 InfluxDB v1。

management.influx.metrics.export.retention-policy

要使用的保留策略(如果未指定,Influx 会写入到 DEFAULT 保留策略)。仅限 InfluxDB v1。

management.influx.metrics.export.retention-replication-factor

数据在集群中存储的副本数量。对于单节点实例,必须为 1。仅限 InfluxDB v1。

management.influx.metrics.export.retention-shard-duration

分片组覆盖的时间范围。例如 2w,有关持续时间格式的更多详细信息,请查阅 Influx 文档。仅限 InfluxDB v1。

management.influx.metrics.export.step

要使用的步长(即报告频率)。

1m

management.influx.metrics.export.token

用于调用 InfluxDB 后端的认证令牌。对于 InfluxDB v1,使用 Bearer 方案。对于 v2,使用 Token 方案。

management.influx.metrics.export.uri

Influx 服务器的 URI。

http://localhost:8086

management.influx.metrics.export.user-name

Influx 服务器的登录用户。仅限 InfluxDB v1。

management.info.build.enabled

是否启用构建信息。

true

management.info.defaults.enabled

是否启用默认信息贡献者。

true

management.info.env.enabled

是否启用环境信息。

false

management.info.git.enabled

是否启用 Git 信息。

true

management.info.git.mode

用于暴露 Git 信息的模式。

simple

management.info.java.enabled

是否启用 Java 信息。

false

management.info.os.enabled

是否启用操作系统信息。

false

management.info.process.enabled

是否启用进程信息。

false

management.info.ssl.enabled

是否启用 SSL 证书信息。

false

management.jmx.metrics.export.domain

指标 JMX 域名。

metrics

management.jmx.metrics.export.enabled

是否启用将指标导出到此后端。

true

management.jmx.metrics.export.step

要使用的步长(即报告频率)。

1m

management.kairos.metrics.export.batch-size

对于此后端,每次请求使用的测量值数量。如果发现更多测量值,则会发出多个请求。

10000

management.kairos.metrics.export.connect-timeout

对此后端请求的连接超时时间。

1s

management.kairos.metrics.export.enabled

是否启用将指标导出到此后端。

true

management.kairos.metrics.export.password

KairosDB 服务器的登录密码。

management.kairos.metrics.export.read-timeout

对此后端请求的读取超时时间。

10s

management.kairos.metrics.export.step

要使用的步长(即报告频率)。

1m

management.kairos.metrics.export.uri

KairosDB 服务器的 URI。

http://localhost:8080/api/v1/datapoints

management.kairos.metrics.export.user-name

KairosDB 服务器的登录用户。

management.logging.export.enabled

是否启用日志自动配置以导出日志。

true

management.metrics.data.repository.autotime.enabled

是否启用自动计时。

true

management.metrics.data.repository.autotime.percentiles

应发布附加时间序列的百分位数。

management.metrics.data.repository.autotime.percentiles-histogram

是否发布百分位数直方图。

false

management.metrics.data.repository.metric-name

已发送请求的指标名称。

spring.data.repository.invocations

management.metrics.distribution.buffer-length.*

以指定名称开头的 Meter ID 保留在环形缓冲区中的直方图数量。最长匹配获胜,键 all 也可用于配置所有 Meter。

management.metrics.distribution.expiry.*

以指定名称开头的 Meter ID 的样本在重置和轮换之前累积到衰减分布统计信息的最大时间量。最长匹配获胜,键 all 也可用于配置所有 Meter。

management.metrics.distribution.maximum-expected-value.*

以指定名称开头的 Meter ID 预计观察到的最大值。最长匹配获胜。值可以指定为双精度浮点数或 Duration 值(对于计时器 Meter,如果未指定单位,则默认为毫秒)。

management.metrics.distribution.minimum-expected-value.*

以指定名称开头的 Meter ID 预计观察到的最小值。最长匹配获胜。值可以指定为双精度浮点数或 Duration 值(对于计时器 Meter,如果未指定单位,则默认为毫秒)。

management.metrics.distribution.percentiles.*

要发送到后端以指定名称开头的 Meter ID 的特定计算的不可聚合百分位数。最长匹配获胜,键 'all' 也可用于配置所有 Meter。

management.metrics.distribution.percentiles-histogram.*

以指定名称开头的 Meter ID 是否应发布百分位数直方图。对于支持基于直方图的可聚合百分位数计算的监控系统,可以将其设置为 true。对于其他系统,这没有影响。最长匹配获胜,键 'all' 也可用于配置所有 Meter。

management.metrics.distribution.slo.*

以指定名称开头的 Meter ID 的特定服务级别目标边界。最长匹配获胜。将为每个指定的边界发布计数器。值可以指定为双精度浮点数或 Duration 值(对于计时器 Meter,如果未指定单位,则默认为毫秒)。

management.metrics.enable.*

以指定名称开头的 Meter ID 是否应启用。最长匹配获胜,键 'all' 也可用于配置所有 Meter。

management.metrics.mongo.command.enabled

是否启用 Mongo 客户端命令指标。

true

management.metrics.mongo.connectionpool.enabled

是否启用 Mongo 连接池指标。

true

management.metrics.system.diskspace.paths

报告磁盘指标的路径列表。

[.]

management.metrics.tags.*

应用于每个 Meter 的通用标签。

management.metrics.use-global-registry

自动配置的 MeterRegistry 实现是否应绑定到 Metrics 上的全局静态注册表。对于测试,将其设置为 'false' 以最大化测试独立性。

true

management.metrics.web.client.max-uri-tags

允许的最大唯一 URI 标签值数量。达到最大标签值数量后,带有额外标签值的指标将被过滤器拒绝。

100

management.metrics.web.server.max-uri-tags

允许的最大唯一 URI 标签值数量。达到最大标签值数量后,带有额外标签值的指标将被过滤器拒绝。

100

management.newrelic.metrics.export.account-id

New Relic 账户 ID。

management.newrelic.metrics.export.api-key

New Relic API 密钥。

management.newrelic.metrics.export.batch-size

对于此后端,每次请求使用的测量值数量。如果发现更多测量值,则会发出多个请求。

10000

management.newrelic.metrics.export.client-provider-type

要使用的客户端提供者类型。

insights-api

management.newrelic.metrics.export.connect-timeout

对此后端请求的连接超时时间。

1s

management.newrelic.metrics.export.enabled

是否启用将指标导出到此后端。

true

management.newrelic.metrics.export.event-type

应发布的事件类型。如果 'meter-name-event-type-enabled' 设置为 'true',此属性将被忽略。

SpringBootSample

management.newrelic.metrics.export.meter-name-event-type-enabled

是否将 Meter 名称作为事件类型发送,而不是使用 'event-type' 配置属性值。如果未遵循 New Relic 指南或需要与之前 Spring Boot 版本一致的事件类型,则可以设置为 'true'。

false

management.newrelic.metrics.export.read-timeout

对此后端请求的读取超时时间。

10s

management.newrelic.metrics.export.step

要使用的步长(即报告频率)。

1m

management.newrelic.metrics.export.uri

用于发送指标的 URI。

https://insights-collector.newrelic.com

management.observations.annotations.enabled

是否启用 Micrometer 注解的自动配置。

false

management.observations.enable.*

以指定名称开头的观察是否应启用。最长匹配获胜,键 'all' 也可用于配置所有观察。

management.observations.http.client.requests.name

客户端请求的观察名称。

http.client.requests

management.observations.http.server.requests.name

服务器请求的观察名称。

http.server.requests

management.observations.key-values.*

应用于每个观察的通用键值对。

management.observations.long-task-timer.enabled

是否为每个观察创建 LongTaskTimer。

true

management.observations.r2dbc.include-parameter-values

是否标记实际查询参数值。

false

management.opentelemetry.resource-attributes.*

资源属性。

management.otlp.logging.compression

用于压缩有效负载的方法。

management.otlp.logging.connect-timeout

OTel 收集器连接的连接超时。

10s

management.otlp.logging.endpoint

OTel 收集器的 HTTP API URL。

management.otlp.logging.export.enabled

是否启用日志自动配置以导出 OTLP 日志。

management.otlp.logging.headers.*

要传递给收集器的自定义 HTTP 头,例如 auth 头。

management.otlp.logging.timeout

OTel 收集器处理导出批次数据的调用超时。此超时跨越整个调用过程:解析 DNS、连接、写入请求体、服务器处理和读取响应体。如果调用需要重定向或重试,则所有操作都必须在一个超时周期内完成。

10s

management.otlp.logging.transport

用于发送日志的传输方式。

http

management.otlp.metrics.export.aggregation-temporality

求和的聚合时间性。它定义了如何表示可加值。此设置取决于您使用的后端,有些只支持一种时间性。

cumulative

management.otlp.metrics.export.base-time-unit

导出指标的时间单位。

milliseconds

management.otlp.metrics.export.batch-size

对于此后端,每次请求使用的测量值数量。如果发现更多测量值,则会发出多个请求。

10000

management.otlp.metrics.export.connect-timeout

对此后端请求的连接超时时间。

1s

management.otlp.metrics.export.enabled

是否启用将指标导出到此后端。

true

management.otlp.metrics.export.headers.*

导出指标的头。

management.otlp.metrics.export.histogram-flavor

启用直方图发布时优先使用的直方图类型。

explicit-bucket-histogram

management.otlp.metrics.export.max-bucket-count

如果配置了指数直方图,则使用的最大桶数。这对显式桶直方图没有影响。

160

management.otlp.metrics.export.max-scale

如果配置了指数直方图,则使用的最大比例。

20

management.otlp.metrics.export.read-timeout

对此后端请求的读取超时时间。

10s

management.otlp.metrics.export.step

要使用的步长(即报告频率)。

1m

management.otlp.metrics.export.url

OTLP 服务器的 URI。

http://localhost:4318/v1/metrics

management.otlp.tracing.compression

用于压缩有效负载的方法。

management.otlp.tracing.connect-timeout

OTel 收集器连接的连接超时。

10s

management.otlp.tracing.endpoint

OTel 收集器的 HTTP API URL。

management.otlp.tracing.export.enabled

是否启用跟踪自动配置以导出 OTLP 跟踪。

management.otlp.tracing.headers.*

要传递给收集器的自定义 HTTP 头,例如 auth 头。

management.otlp.tracing.timeout

OTel 收集器处理导出批次数据的调用超时。此超时跨越整个调用过程:解析 DNS、连接、写入请求体、服务器处理和读取响应体。如果调用需要重定向或重试,则所有操作都必须在一个超时周期内完成。

10s

management.otlp.tracing.transport

用于发送 Span 的传输方式。

http

management.prometheus.metrics.export.descriptions

是否启用将描述作为抓取有效负载的一部分发布到 Prometheus。关闭此选项可最大程度地减少每次抓取发送的数据量。

true

management.prometheus.metrics.export.enabled

是否启用将指标导出到此后端。

true

management.prometheus.metrics.export.properties.*

要传递给 Prometheus 客户端的附加属性。

management.prometheus.metrics.export.pushgateway.base-url

Pushgateway 的基本 URL。

http://localhost:9091

management.prometheus.metrics.export.pushgateway.enabled

通过 Prometheus Pushgateway 启用发布。

false

management.prometheus.metrics.export.pushgateway.grouping-key.*

推送指标的分组键。

management.prometheus.metrics.export.pushgateway.job

此应用程序实例的作业标识符。

management.prometheus.metrics.export.pushgateway.password

Prometheus Pushgateway 的登录密码。

management.prometheus.metrics.export.pushgateway.push-rate

推送指标的频率。

1m

management.prometheus.metrics.export.pushgateway.shutdown-operation

关闭时应执行的操作。

management.prometheus.metrics.export.pushgateway.username

Prometheus Pushgateway 的登录用户。

management.prometheus.metrics.export.step

要使用的步长(即报告频率)。

1m

management.server.add-application-context-header

在每个响应中添加 "X-Application-Context" HTTP 头。

false

management.server.address

管理端点应绑定的网络地址。需要自定义 management.server.port。

management.server.base-path

管理端点基本路径(例如,'/management')。需要自定义 management.server.port。

management.server.port

管理端点 HTTP 端口(默认使用与应用程序相同的端口)。配置不同的端口以使用特定于管理的 SSL。

management.server.ssl.bundle

配置的 SSL 包名称。

management.server.ssl.certificate

PEM 编码的 SSL 证书文件路径。

management.server.ssl.certificate-private-key

SSL 证书的 PEM 编码私钥文件路径。

management.server.ssl.ciphers

支持的 SSL 密码套件。

management.server.ssl.client-auth

客户端认证模式。需要信任库。

management.server.ssl.enabled

是否启用 SSL 支持。

true

management.server.ssl.enabled-protocols

启用的 SSL 协议。

management.server.ssl.key-alias

标识密钥库中密钥的别名。

management.server.ssl.key-password

用于访问密钥库中密钥的密码。

management.server.ssl.key-store

包含 SSL 证书的密钥库路径(通常是 jks 文件)。

management.server.ssl.key-store-password

用于访问密钥库的密码。

management.server.ssl.key-store-provider

密钥库的提供者。

management.server.ssl.key-store-type

密钥库类型。

management.server.ssl.protocol

要使用的 SSL 协议。

TLS

management.server.ssl.server-name-bundles

用于 SNI 配置的主机名到 SSL 包的映射。

management.server.ssl.trust-certificate

PEM 编码的 SSL 证书颁发机构文件路径。

management.server.ssl.trust-certificate-private-key

SSL 证书颁发机构的 PEM 编码私钥文件路径。

management.server.ssl.trust-store

包含 SSL 证书的信任库。

management.server.ssl.trust-store-password

用于访问信任库的密码。

management.server.ssl.trust-store-provider

信任库的提供者。

management.server.ssl.trust-store-type

信任库类型。

management.signalfx.metrics.export.access-token

SignalFX 访问令牌。

management.signalfx.metrics.export.batch-size

对于此后端,每次请求使用的测量值数量。如果发现更多测量值,则会发出多个请求。

10000

management.signalfx.metrics.export.connect-timeout

对此后端请求的连接超时时间。

1s

management.signalfx.metrics.export.enabled

是否启用将指标导出到此后端。

true

management.signalfx.metrics.export.published-histogram-type

要发布的直方图类型。

default

management.signalfx.metrics.export.read-timeout

对此后端请求的读取超时时间。

10s

management.signalfx.metrics.export.source

唯一标识向 SignalFx 发布指标的应用程序实例。默认为本地主机名。

management.signalfx.metrics.export.step

要使用的步长(即报告频率)。

10s

management.signalfx.metrics.export.uri

用于发送指标的 URI。

https://ingest.signalfx.com

management.simple.metrics.export.enabled

是否启用将指标导出到此后端。

true

management.simple.metrics.export.mode

计数模式。

cumulative

management.simple.metrics.export.step

要使用的步长(即报告频率)。

1m

management.stackdriver.metrics.export.batch-size

对于此后端,每次请求使用的测量值数量。如果发现更多测量值,则会发出多个请求。

10000

management.stackdriver.metrics.export.connect-timeout

对此后端请求的连接超时时间。

1s

management.stackdriver.metrics.export.enabled

是否启用将指标导出到此后端。

true

management.stackdriver.metrics.export.metric-type-prefix

指标类型前缀。有效前缀在 Google Cloud 文档中描述 (https://cloud.google.com/monitoring/custom-metrics#identifier)。

custom.googleapis.com/

management.stackdriver.metrics.export.project-id

要监控的 Google Cloud 项目标识符。

management.stackdriver.metrics.export.read-timeout

对此后端请求的读取超时时间。

10s

management.stackdriver.metrics.export.resource-labels.*

受监控资源的标签。

management.stackdriver.metrics.export.resource-type

受监控的资源类型。

global

management.stackdriver.metrics.export.step

要使用的步长(即报告频率)。

1m

management.stackdriver.metrics.export.use-semantic-metric-types

是否使用语义正确的指标类型。当为 false 时,计数器指标以 GAUGE MetricKind 发布。当为 true 时,计数器指标以 CUMULATIVE MetricKind 发布。

false

management.statsd.metrics.export.buffered

在发送到 StatsD 服务器之前是否应对测量值进行缓冲。

true

management.statsd.metrics.export.enabled

是否启用将指标导出到 StatsD。

true

management.statsd.metrics.export.flavor

要使用的 StatsD 行协议。

datadog

management.statsd.metrics.export.host

接收导出指标的 StatsD 服务器主机。

localhost

management.statsd.metrics.export.max-packet-length

单个有效载荷的总长度应保持在您网络的 MTU 范围内。

1400

management.statsd.metrics.export.polling-frequency

仪表轮询的频率。当仪表被轮询时,其值会被重新计算,如果值已更改(或 publishUnchangedMeters 为 true),则会发送到 StatsD 服务器。

10s

management.statsd.metrics.export.port

接收导出指标的 StatsD 服务器端口。

8125

management.statsd.metrics.export.protocol

接收导出指标的 StatsD 服务器协议。

udp

management.statsd.metrics.export.publish-unchanged-meters

是否将未更改的仪表发送到 StatsD 服务器。

true

management.statsd.metrics.export.step

计算最大值等窗口统计信息时使用的步长。为了充分利用这些统计信息,请将步长间隔与您的抓取间隔对齐。

1m

management.tracing.baggage.correlation.enabled

是否启用行李箱上下文与日志上下文的关联。

true

management.tracing.baggage.correlation.fields

应与日志上下文关联的字段列表。这意味着这些字段最终将成为键值对,例如在 MDC 中。

management.tracing.baggage.enabled

是否启用 Micrometer Tracing 行李箱传播。

true

management.tracing.baggage.local-fields

应在 JVM 进程内可访问但不应通过网络传播的字段列表。OpenTelemetry 不支持本地字段。

management.tracing.baggage.remote-fields

在进程内和网络上传播时引用方式相同的字段列表。例如,字段 "x-vcap-request-id" 将按原样设置,包括前缀。

management.tracing.baggage.tag-fields

应自动成为标签的字段列表。

management.tracing.brave.span-joining-supported

传播类型和跟踪后端是否支持在客户端和服务端 spans 之间共享 span ID。需要 B3 传播和兼容的后端。

false

management.tracing.enabled

是否启用跟踪的自动配置,用于导出和传播跟踪。

true

management.tracing.propagation.consume

应用程序使用的跟踪上下文传播类型。

[W3C, B3, B3_MULTI]

management.tracing.propagation.produce

应用程序生成的跟踪上下文传播类型。

[W3C]

management.tracing.propagation.type

应用程序生成和使用的跟踪上下文传播类型。设置此属性会覆盖更精细的传播类型属性。

management.tracing.sampling.probability

跟踪将被采样到的概率,范围从 0.0 到 1.0。

0.1

management.wavefront.api-token

直接向 Wavefront API 主机发布指标和跟踪时使用的 API token。

management.wavefront.api-token-type

API token 的类型。

management.wavefront.application.cluster-name

在 ApplicationTags 中使用的 Wavefront 集群名称。

management.wavefront.application.custom-tags.*

在 ApplicationTags 中使用的 Wavefront 自定义标签。

management.wavefront.application.name

在 ApplicationTags 中使用的 Wavefront 'Application' 名称。

unnamed_application

management.wavefront.application.service-name

在 ApplicationTags 中使用的 Wavefront 'Service' 名称,如果未设置,则回退到 'spring.application.name'。如果两者都未设置,则默认为 'unnamed_service'。

management.wavefront.application.shard-name

在 ApplicationTags 中使用的 Wavefront Shard 名称。

management.wavefront.metrics.export.batch-size

对于此后端,每次请求使用的测量值数量。如果发现更多测量值,则会发出多个请求。

10000

management.wavefront.metrics.export.connect-timeout

对此后端请求的连接超时时间。

1s

management.wavefront.metrics.export.enabled

是否启用将指标导出到此后端。

true

management.wavefront.metrics.export.global-prefix

全局前缀,用于在 Wavefront UI 中查看时,将源自此应用的插桩的指标与源自其他 Wavefront 集成的指标分开。

management.wavefront.metrics.export.read-timeout

对此后端请求的读取超时时间。

10s

management.wavefront.metrics.export.report-day-distribution

是否报告按天间隔聚合的直方图分布。

false

management.wavefront.metrics.export.report-hour-distribution

是否报告按小时间隔聚合的直方图分布。

false

management.wavefront.metrics.export.report-minute-distribution

是否报告按分钟间隔聚合的直方图分布。

true

management.wavefront.metrics.export.step

要使用的步长(即报告频率)。

1m

management.wavefront.sender.batch-size

Wavefront 每请求使用的测量数量。如果找到更多测量,则会发出多个请求。

10000

management.wavefront.sender.flush-interval

发送排队消息的刷新间隔。

1s

management.wavefront.sender.max-queue-size

排队消息的最大大小。

50000

management.wavefront.sender.message-size

消息的最大大小。

management.wavefront.source

发布到 Wavefront 的指标和跟踪的应用程序实例的唯一标识符。默认为本地主机名。

management.wavefront.trace-derived-custom-tag-keys

RED 指标的自定义 span 标签。

management.wavefront.tracing.export.enabled

是否启用跟踪的自动配置以导出 Wavefront 跟踪。

management.wavefront.uri

发送指标和跟踪的 URI。

https://longboard.wavefront.com

management.zipkin.tracing.connect-timeout

连接 Zipkin 请求的连接超时。

1s

management.zipkin.tracing.encoding

如何编码发送到 Zipkin API 的 POST 请求体。

[JSON]

management.zipkin.tracing.endpoint

Zipkin API 的 URL。

http://localhost:9411/api/v2/spans

management.zipkin.tracing.export.enabled

是否启用跟踪的自动配置以导出 Zipkin 跟踪。

management.zipkin.tracing.read-timeout

连接 Zipkin 请求的读取超时。

10s

缓存属性

名称 描述 默认值

spring.cache.cache-names

如果底层缓存管理器支持,要创建的缓存名称列表。通常,这会禁用即时创建额外缓存的能力。

spring.cache.caffeine.spec

用于创建缓存的 spec。有关 spec 格式的更多详细信息,请参阅 CaffeineSpec。

spring.cache.couchbase.expiration

条目过期时间。默认情况下,条目永不过期。请注意,此值最终会转换为秒。

spring.cache.infinispan.config

用于初始化 Infinispan 的配置文件的位置。

spring.cache.jcache.config

用于初始化缓存管理器的配置文件的位置。此配置文件取决于底层缓存实现。

spring.cache.jcache.provider

用于检索符合 JSR-107 的缓存管理器的 CachingProvider 实现的完全限定名。仅当 classpath 中有多个 JSR-107 实现可用时才需要。

spring.cache.redis.cache-null-values

是否允许缓存 null 值。

true

spring.cache.redis.enable-statistics

是否启用缓存统计信息。

false

spring.cache.redis.key-prefix

键前缀。

spring.cache.redis.time-to-live

条目过期时间。默认情况下,条目永不过期。

spring.cache.redis.use-key-prefix

写入 Redis 时是否使用键前缀。

true

spring.cache.type

缓存类型。默认根据环境自动检测。

核心属性

名称 描述 默认值

debug

启用调试日志。

false

info.*

要添加到 info endpoint 的任意属性。

logging.charset.console

用于控制台输出的字符集。

logging.charset.file

用于文件输出的字符集。

logging.config

日志配置文件的位置。例如,Logback 的 classpath:logback.xml

logging.exception-conversion-word

记录异常时使用的转换词。

%wEx

logging.file.name

日志文件名(例如,myapp.log)。名称可以是精确位置或相对于当前目录的位置。

logging.file.path

日志文件的位置。例如,/var/log

logging.group.*

日志组,用于同时快速更改多个日志记录器。例如,logging.group.db=org.hibernate,org.springframework.jdbc

logging.include-application-group

是否在日志中包含应用程序组。

true

logging.include-application-name

是否在日志中包含应用程序名称。

true

logging.level.*

日志级别严重程度映射。例如,logging.level.org.springframework=DEBUG

logging.log4j2.config.override

用于创建复合配置的覆盖配置文件。

logging.logback.rollingpolicy.clean-history-on-start

启动时是否清理归档日志文件。

false

logging.logback.rollingpolicy.file-name-pattern

滚动日志文件名的模式。

${LOG_FILE}.%d{yyyy-MM-dd}.%i.gz

logging.logback.rollingpolicy.max-file-size

最大日志文件大小。

10MB

logging.logback.rollingpolicy.max-history

要保留的最大归档日志文件数量。

7

logging.logback.rollingpolicy.total-size-cap

要保留的日志备份总大小。

0B

logging.pattern.console

用于输出到控制台的 Appender 模式。其默认值因日志系统而异。

logging.pattern.correlation

用于日志关联的 Appender 模式。其默认值因日志系统而异。

logging.pattern.dateformat

用于日志日期格式的 Appender 模式。

yyyy-MM-dd'T'HH:mm:ss.SSSXXX

logging.pattern.file

用于输出到文件的 Appender 模式。其默认值因日志系统而异。

logging.pattern.level

用于日志级别的 Appender 模式。

%5p

logging.register-shutdown-hook

日志系统初始化时注册关闭钩子。当部署为 war 文件时自动禁用。

true

logging.structured.ecs.service.environment

结构化 ECS 服务环境。

logging.structured.ecs.service.name

结构化 ECS 服务名称(默认为 'spring.application.name')。

logging.structured.ecs.service.node-name

结构化 ECS 服务节点名称。

logging.structured.ecs.service.version

结构化 ECS 服务版本(默认为 'spring.application.version')。

logging.structured.format.console

用于输出到控制台的结构化日志格式。必须是格式 ID 或完全限定类名。

logging.structured.format.file

用于输出到文件的结构化日志格式。必须是格式 ID 或完全限定类名。

logging.structured.gelf.host

结构化 GELF 主机(默认为 'spring.application.name')。

logging.structured.gelf.service.version

结构化 GELF 服务版本(默认为 'spring.application.version')。

logging.structured.json.add.*

应添加到结构化日志 JSON 中的额外成员。

logging.structured.json.customizer

StructuredLoggingJsonMembersCustomizer 的完全限定类名。

logging.structured.json.exclude

应从结构化日志 JSON 中排除的成员路径。

logging.structured.json.include

应包含在结构化日志 JSON 中的成员路径。

logging.structured.json.rename.*

成员路径与应在结构化日志 JSON 中使用的备用名称之间的映射。

logging.threshold.console

控制台输出的日志级别阈值。

TRACE

logging.threshold.file

文件输出的日志级别阈值。

TRACE

spring.aop.auto

添加 @EnableAspectJAutoProxy。

true

spring.aop.proxy-target-class

是否创建基于子类 (CGLIB) 的代理(true),而不是标准的基于 Java 接口的代理(false)。

true

spring.application.admin.enabled

是否为应用程序启用管理功能。

false

spring.application.admin.jmx-name

应用程序管理 MBean 的 JMX 名称。

org.springframework.boot:type=Admin,name=SpringApplication

spring.application.group

应用程序组。

spring.application.name

应用程序名称。

spring.application.version

应用程序版本(默认为 manifest 中的 'Implementation-Version')。

spring.autoconfigure.exclude

要排除的自动配置类。

spring.banner.charset

Banner 文件编码。

UTF-8

spring.banner.location

Banner 文本资源位置。

classpath:banner.txt

spring.beaninfo.ignore

是否跳过 BeanInfo 类的搜索。

true

spring.codec.log-request-details

是否在 DEBUG 级别记录表单数据,在 TRACE 级别记录请求头。

false

spring.codec.max-in-memory-size

无论何时需要聚合输入流时,可缓冲的最大字节数限制。这仅适用于自动配置的 WebFlux 服务器和 WebClient 实例。默认未设置此值,此时应用各个编解码器的默认值。大多数编解码器默认限制为 256K。

spring.config.activate.on-cloud-platform

包含此文档所需的云平台。

spring.config.activate.on-profile

要包含此文档需要匹配的 profile 表达式。

spring.config.additional-location

在默认位置之外使用的配置文件位置。

spring.config.import

导入额外的配置数据。

spring.config.location

替换默认位置的配置文件位置。

spring.config.name

配置文件名称。

application

spring.info.build.encoding

文件编码。

UTF-8

spring.info.build.location

生成的 build-info.properties 文件的位置。

classpath:META-INF/build-info.properties

spring.info.git.encoding

文件编码。

UTF-8

spring.info.git.location

生成的 git.properties 文件的位置。

classpath:git.properties

spring.jmx.default-domain

JMX 域名。

spring.jmx.enabled

将 Spring 的管理 Bean 暴露给 JMX 域。

false

spring.jmx.registration-policy

JMX 注册策略。

fail-on-existing

spring.jmx.server

MBeanServer bean 名称。

mbeanServer

spring.jmx.unique-names

是否应确保唯一的运行时对象名称。

false

spring.lifecycle.timeout-per-shutdown-phase

任意阶段(具有相同 'phase' 值的 SmartLifecycle Bean 组)关闭的超时时间。

30s

spring.main.allow-bean-definition-overriding

是否允许通过注册与现有定义同名的定义来覆盖 Bean 定义。

false

spring.main.allow-circular-references

是否允许 Bean 之间的循环引用并自动尝试解决它们。

false

spring.main.banner-mode

应用程序运行时显示 banner 的模式。如果启用了结构化日志记录,则默认为 'off',否则为 'console'。

spring.main.cloud-platform

覆盖云平台的自动检测。

spring.main.keep-alive

即使没有更多的非守护线程,是否也保持应用程序运行。

false

spring.main.lazy-initialization

初始化是否应延迟执行。

false

spring.main.log-startup-info

应用程序启动时是否记录应用程序信息。

true

spring.main.register-shutdown-hook

应用程序是否应注册关闭钩子。

true

spring.main.sources

包含在 ApplicationContext 中的源(类名、包名或 XML 资源位置)。

spring.main.web-application-type

用于显式请求特定类型 Web 应用程序的标志。如果未设置,则根据 classpath 自动检测。

spring.mandatory-file-encoding

应用程序必须使用的预期字符编码。

spring.messages.always-use-message-format

是否始终应用 MessageFormat 规则,即使解析没有参数的消息。

false

spring.messages.basename

basename 列表(本质上是一个完全限定的 classpath 位置),每个 basename 都遵循 ResourceBundle 约定,并放宽了对斜杠路径的支持。如果不包含包限定符(例如 "org.mypackage"),则将从 classpath 根目录解析。

[messages]

spring.messages.cache-duration

加载的资源束文件的缓存持续时间。未设置时,束会永久缓存。如果未指定持续时间后缀,将使用秒作为单位。

spring.messages.common-messages

包含通用消息的与区域设置无关的属性文件资源列表。

spring.messages.encoding

消息束编码。

UTF-8

spring.messages.fallback-to-system-locale

如果没有找到特定 Locale 的文件,是否回退到系统 Locale。如果关闭此选项,唯一的回退将是默认文件(例如,对于 basename "messages",回退到 "messages.properties")。

true

spring.messages.use-code-as-default-message

是否使用消息代码作为默认消息,而不是抛出 "NoSuchMessageException"。仅建议在开发期间使用。

false

spring.output.ansi.enabled

配置 ANSI 输出。

detect

spring.pid.fail-on-write-error

如果使用了 ApplicationPidFileWriter 但无法写入 PID 文件时是否失败。

spring.pid.file

要写入的 PID 文件的位置(如果使用了 ApplicationPidFileWriter)。

spring.profiles.active

逗号分隔的活动 profile 列表。可以通过命令行开关覆盖。

spring.profiles.default

如果没有活动 profile 时要启用的 profile 名称。

default

spring.profiles.group.*

profile 组,用于定义相关 profile 组的逻辑名称。

spring.profiles.include

无条件激活指定的逗号分隔的 profile 列表(如果使用 YAML,则为 profile 列表)。

spring.quartz.auto-startup

初始化后是否自动启动调度器。

true

spring.quartz.jdbc.comment-prefix

SQL 初始化脚本中单行注释的前缀。

[#, --]

spring.quartz.jdbc.initialize-schema

数据库 schema 初始化模式。

embedded

spring.quartz.jdbc.platform

如果在初始化脚本中使用了 @@platform@@ 占位符,则使用此平台。默认自动检测。

spring.quartz.jdbc.schema

用于初始化数据库 schema 的 SQL 文件路径。

classpath:org/quartz/impl/jdbcjobstore/tables_@@platform@@.sql

spring.quartz.job-store-type

Quartz 作业存储类型。

memory

spring.quartz.overwrite-existing-jobs

配置的作业是否应覆盖现有的作业定义。

false

spring.quartz.properties.*

额外的 Quartz 调度器属性。

spring.quartz.scheduler-name

调度器的名称。

quartzScheduler

spring.quartz.startup-delay

调度器初始化完成后延迟启动的时间。如果在整个应用程序启动完成之前不应运行任何作业,则设置此属性有意义。

0s

spring.quartz.wait-for-jobs-to-complete-on-shutdown

应用程序关闭时是否等待正在运行的作业完成。

false

spring.reactor.context-propagation

Reactor 操作符的上下文传播支持模式。

limited

spring.reactor.debug-agent.enabled

当 reactor-tools 存在时,是否应启用 Reactor Debug Agent。

true

spring.reactor.netty.shutdown-quiet-period

在关闭资源之前等待的时间量。

spring.ssl.bundle.jks.*

Java 密钥库 SSL 信任材料。

spring.ssl.bundle.pem.*

PEM 编码的 SSL 信任材料。

spring.ssl.bundle.watch.file.quiet-period

静默期,在此之后检测到更改。

10s

spring.task.execution.pool.allow-core-thread-timeout

是否允许核心线程超时。这使得线程池能够动态增长和收缩。如果启用了虚拟线程,则此设置无效。

true

spring.task.execution.pool.core-size

核心线程数。如果启用了虚拟线程,则此设置无效。

8

spring.task.execution.pool.keep-alive

线程在终止前可以保持空闲的时间限制。如果启用了虚拟线程,则此设置无效。

60s

spring.task.execution.pool.max-size

允许的最大线程数。如果任务填满了队列,线程池可以扩展到此大小以应对负载。如果队列无界,则忽略此设置。如果启用了虚拟线程,则此设置无效。

spring.task.execution.pool.queue-capacity

队列容量。无界容量不会增加线程池大小,因此会忽略 "max-size" 属性。如果启用了虚拟线程,则此设置无效。

spring.task.execution.pool.shutdown.accept-tasks-after-context-close

在应用程序上下文关闭阶段开始后,是否接受进一步的任务。

false

spring.task.execution.shutdown.await-termination

执行器在关闭时是否应等待已计划的任务完成。

false

spring.task.execution.shutdown.await-termination-period

执行器应等待剩余任务完成的最大时间。

spring.task.execution.simple.concurrency-limit

设置允许的最大并行访问数。-1 表示完全没有并发限制。

spring.task.execution.thread-name-prefix

新创建线程名称使用的前缀。

task-

spring.task.scheduling.pool.size

允许的最大线程数。如果启用了虚拟线程,则此设置无效。

1

spring.task.scheduling.shutdown.await-termination

执行器在关闭时是否应等待已计划的任务完成。

false

spring.task.scheduling.shutdown.await-termination-period

执行器应等待剩余任务完成的最大时间。

spring.task.scheduling.simple.concurrency-limit

设置允许的最大并行访问数。-1 表示完全没有并发限制。

spring.task.scheduling.thread-name-prefix

新创建线程名称使用的前缀。

scheduling-

spring.threads.virtual.enabled

是否使用虚拟线程。

false

trace

启用跟踪日志。

false

数据迁移属性

名称 描述 默认值

spring.flyway.baseline-description

应用基线时,用于标记现有 schema 的描述。

<< Flyway Baseline >>

spring.flyway.baseline-on-migrate

迁移非空 schema 时是否自动调用 baseline。

false

spring.flyway.baseline-version

执行 baseline 时,用于标记现有 schema 的版本。

1

spring.flyway.batch

执行 SQL 语句时是否进行批量处理。

spring.flyway.clean-disabled

是否禁用数据库清理。

true

spring.flyway.community-db-support-enabled

是否启用社区数据库支持。

false

spring.flyway.connect-retries

尝试连接数据库时的最大重试次数。

0

spring.flyway.connect-retries-interval

尝试连接数据库时,重试之间的最大时间间隔。如果未指定持续时间后缀,将使用秒作为单位。

120s

spring.flyway.create-schemas

Flyway 是否应尝试创建 schemas 属性中指定的 schema。

true

spring.flyway.default-schema

Flyway 管理的默认 schema 名称(区分大小写)。

spring.flyway.detect-encoding

是否尝试自动检测 SQL 迁移文件的编码。

spring.flyway.driver-class-name

JDBC 驱动程序的完全限定名。默认情况下根据 URL 自动检测。

spring.flyway.enabled

是否启用 flyway。

true

spring.flyway.encoding

SQL 迁移的编码。

UTF-8

spring.flyway.error-overrides

内置错误处理的规则,用于覆盖特定的 SQL 状态和错误代码。需要 Flyway Teams 版本。

spring.flyway.execute-in-transaction

Flyway 是否应在事务内执行 SQL。

true

spring.flyway.fail-on-missing-locations

如果迁移脚本位置不存在时是否失败。

false

spring.flyway.group

应用所有待处理迁移时是否将其分组到同一个事务中。

false

spring.flyway.ignore-migration-patterns

执行验证时要忽略的迁移标识模式列表。

spring.flyway.init-sqls

在获取连接后立即执行的 SQL 语句,用于初始化连接。

spring.flyway.installed-by

在 schema history 表中记录的应用迁移的用户名。

spring.flyway.jdbc-properties.*

传递给 JDBC 驱动程序的属性。

spring.flyway.kerberos-config-file

Kerberos 配置文件的路径。需要 Flyway Teams 版本。

spring.flyway.locations

迁移脚本的位置。可以包含特殊的 "{vendor}" 占位符以使用特定于供应商的位置。

[classpath:db/migration]

spring.flyway.lock-retry-count

尝试获取锁时的最大重试次数。

50

spring.flyway.loggers

Flyway 应使用的日志记录器。

[slf4j]

spring.flyway.mixed

是否允许在同一迁移中混合使用事务性和非事务性语句。

false

spring.flyway.oracle.kerberos-cache-file

Oracle Kerberos 缓存文件的路径。需要 Flyway Teams 版本。

spring.flyway.oracle.sqlplus

是否启用对 Oracle SQL*Plus 命令的支持。需要 Flyway Teams 版本。

spring.flyway.oracle.sqlplus-warn

当遇到尚未支持的 Oracle SQL*Plus 语句时,是否发出警告而非错误。需要 Flyway Teams 版本。

spring.flyway.oracle.wallet-location

Oracle Wallet 的位置,用于自动登录数据库。需要 Flyway Teams 版本。

spring.flyway.out-of-order

是否允许迁移乱序运行。

false

spring.flyway.output-query-results

Flyway 在执行迁移时是否应输出包含查询结果的表格。

spring.flyway.password

要迁移的数据库的登录密码。

spring.flyway.placeholder-prefix

迁移脚本中占位符的前缀。

${

spring.flyway.placeholder-replacement

在迁移脚本中执行占位符替换。

true

spring.flyway.placeholder-separator

默认占位符的分隔符。

:

spring.flyway.placeholder-suffix

迁移脚本中占位符的后缀。

}

spring.flyway.placeholders.*

应用于 SQL 迁移脚本的占位符及其替换值。

spring.flyway.postgresql.transactional-lock

是否应使用事务咨询锁。如果设置为 false,则改用会话级锁。

spring.flyway.repeatable-sql-migration-prefix

可重复 SQL 迁移的文件名前缀。

R

spring.flyway.schemas

Flyway 管理的 schema 名称(区分大小写)。

spring.flyway.script-placeholder-prefix

迁移脚本中占位符的前缀。

FP__

spring.flyway.script-placeholder-suffix

迁移脚本中占位符的后缀。

__

spring.flyway.skip-default-callbacks

是否跳过默认回调。如果为 true,则仅使用自定义回调。

false

spring.flyway.skip-default-resolvers

是否跳过默认解析器。如果为 true,则仅使用自定义解析器。

false

spring.flyway.skip-executing-migrations

Flyway 是否应跳过执行迁移内容,仅更新 schema history 表。

spring.flyway.sql-migration-prefix

SQL 迁移的文件名前缀。

V

spring.flyway.sql-migration-separator

SQL 迁移的文件名分隔符。

__

spring.flyway.sql-migration-suffixes

SQL 迁移的文件名后缀。

[.sql]

spring.flyway.sqlserver.kerberos-login-file

SQL Server Kerberos 登录文件的路径。需要 Flyway Teams 版本。

spring.flyway.stream

执行 SQL 迁移时是否使用流式处理。

spring.flyway.table

Flyway 将使用的 schema history 表的名称。

flyway_schema_history

spring.flyway.tablespace

创建 schema history 表的表空间。在使用不支持表空间的数据库时忽略此设置。默认使用 Flyway 所用连接的默认表空间。

spring.flyway.target

应考虑迁移到的目标版本。

latest

spring.flyway.url

要迁移的数据库的 JDBC url。如果未设置,则使用主配置的数据源。

spring.flyway.user

要迁移的数据库的登录用户。

spring.flyway.validate-migration-naming

是否验证脚本不符合正确命名约定的迁移和回调。

false

spring.flyway.validate-on-migrate

执行迁移时是否自动调用 validate。

true

spring.liquibase.change-log

Change log 配置路径。

classpath:/db/changelog/db.changelog-master.yaml

spring.liquibase.clear-checksums

是否清除当前 changelog 中的所有 checksum,以便在下次更新时重新计算。

false

spring.liquibase.contexts

要使用的运行时上下文列表。

spring.liquibase.database-change-log-lock-table

用于跟踪并发 Liquibase 使用情况的表名。

DATABASECHANGELOGLOCK

spring.liquibase.database-change-log-table

用于跟踪更改历史记录的表名。

DATABASECHANGELOG

spring.liquibase.default-schema

默认数据库 schema。

spring.liquibase.driver-class-name

JDBC 驱动程序的完全限定名。默认情况下根据 URL 自动检测。

spring.liquibase.drop-first

是否先删除数据库 schema。

false

spring.liquibase.enabled

是否启用 Liquibase 支持。

true

spring.liquibase.label-filter

要使用的运行时标签列表。

spring.liquibase.liquibase-schema

用于 Liquibase 对象的 schema。

spring.liquibase.liquibase-tablespace

用于 Liquibase 对象的表空间。

spring.liquibase.parameters.*

Change log 参数。

spring.liquibase.password

要迁移的数据库的登录密码。

spring.liquibase.rollback-file

执行更新时写入回滚 SQL 的文件。

spring.liquibase.show-summary

是否打印更新操作的摘要。

summary

spring.liquibase.show-summary-output

打印更新操作摘要的位置。

log

spring.liquibase.tag

应用数据库更改时使用的标签名。也可与 "rollbackFile" 一起使用,为与该标签关联的所有现有更改生成回滚脚本。

spring.liquibase.test-rollback-on-update

执行更新前是否应测试回滚。

false

spring.liquibase.ui-service

使用哪个 UIService。

logger

spring.liquibase.url

要迁移的数据库的 JDBC URL。如果未设置,则使用主配置的数据源。

spring.liquibase.user

要迁移的数据库的登录用户。

spring.sql.init.continue-on-error

发生错误时初始化是否应继续。

false

spring.sql.init.data-locations

要应用于数据库的数据 (DML) 脚本位置。

spring.sql.init.encoding

schema 和数据脚本的编码。

spring.sql.init.mode

确定是否执行初始化时应用的模式。

embedded

spring.sql.init.password

应用初始化脚本时使用的数据库密码(如果不同)。

spring.sql.init.platform

在默认 schema 或数据脚本位置 (schema-${platform}.sql 和 data-${platform}.sql) 中使用的平台。

all

spring.sql.init.schema-locations

要应用于数据库的 schema (DDL) 脚本位置。

spring.sql.init.separator

schema 和数据脚本中的语句分隔符。

;

spring.sql.init.username

应用初始化脚本时使用的数据库用户名(如果不同)。

数据属性

名称 描述 默认值

spring.cassandra.compression

Cassandra 二进制协议支持的压缩。

spring.cassandra.config

要使用的配置文件的位置。

spring.cassandra.connection.connect-timeout

建立驱动程序连接时使用的超时时间。

5s

spring.cassandra.connection.init-query-timeout

在连接打开后立即作为初始化过程一部分运行的内部查询所使用的超时时间。

5s

spring.cassandra.contact-points

集群节点的地址,形式为 'host:port',或仅 'host' 以使用配置的端口。

[127.0.0.1:9042]

spring.cassandra.controlconnection.timeout

控制查询所使用的超时时间。

5s

spring.cassandra.keyspace-name

要使用的 Keyspace 名称。

spring.cassandra.local-datacenter

被视为“本地”的数据中心。Contact points 应来自此数据中心。

spring.cassandra.password

服务器的登录密码。

spring.cassandra.pool.heartbeat-interval

在空闲连接上发送消息以确保其仍然活跃的心跳间隔。

30s

spring.cassandra.pool.idle-timeout

空闲连接在被移除前的空闲超时时间。

5s

spring.cassandra.port

如果 contact point 未指定端口,则使用的端口。

9042

spring.cassandra.request.consistency

查询的一致性级别。

spring.cassandra.request.page-size

在单个网络往返中同时检索多少行。

5000

spring.cassandra.request.serial-consistency

查询的串行一致性级别。

spring.cassandra.request.throttler.drain-interval

节流器尝试从队列中取出请求的频率。应设置得足够高,以便每次尝试都能处理队列中的多个条目,但又不会过多地延迟请求。

spring.cassandra.request.throttler.max-concurrent-requests

允许并行执行的最大请求数。

spring.cassandra.request.throttler.max-queue-size

当超过节流阈值时,可以排队的最大请求数。

spring.cassandra.request.throttler.max-requests-per-second

允许的最大请求速率。

spring.cassandra.request.throttler.type

请求节流类型。

spring.cassandra.request.timeout

驱动程序等待请求完成的时间。

2s

spring.cassandra.schema-action

启动时要执行的 schema 操作。

spring.cassandra.session-name

Cassandra 会话的名称。

spring.cassandra.ssl.bundle

SSL bundle 名称。

spring.cassandra.ssl.enabled

是否启用 SSL 支持。

spring.cassandra.username

服务器的登录用户。

spring.couchbase.authentication.jks.location

用于基于证书的集群认证的 Java KeyStore 位置。

spring.couchbase.authentication.jks.password

用于基于证书的集群认证的 Java KeyStore 密码。

spring.couchbase.authentication.jks.private-key-password

用于基于证书的集群认证的私钥密码。

spring.couchbase.authentication.pem.certificates

用于基于证书的集群认证的 PEM 格式证书。

spring.couchbase.authentication.pem.private-key

用于基于证书的集群认证的 PEM 格式私钥。

spring.couchbase.authentication.pem.private-key-password

用于基于证书的集群认证的私钥密码。

spring.couchbase.connection-string

用于定位 Couchbase 集群的连接字符串。

spring.couchbase.env.io.idle-http-connection-timeout

HTTP 连接在被关闭并从连接池中移除之前可能保持空闲的时间长度。

1s

spring.couchbase.env.io.max-endpoints

每个节点的最大 socket 数。

12

spring.couchbase.env.io.min-endpoints

每个节点的最小 socket 数。

1

spring.couchbase.env.ssl.bundle

SSL bundle 名称。

spring.couchbase.env.ssl.enabled

是否启用 SSL 支持。除非另有指定,如果提供了 "bundle",则会自动启用。

spring.couchbase.env.timeouts.analytics

分析服务的超时时间。

75s

spring.couchbase.env.timeouts.connect

桶连接超时时间。

10s

spring.couchbase.env.timeouts.disconnect

桶断开连接超时时间。

10s

spring.couchbase.env.timeouts.key-value

对特定 key-value 进行操作的超时时间。

2500ms

spring.couchbase.env.timeouts.key-value-durable

对具有持久性级别的特定 key-value 进行操作的超时时间。

10s

spring.couchbase.env.timeouts.management

管理操作的超时时间。

75s

spring.couchbase.env.timeouts.query

N1QL 查询操作的超时时间。

75s

spring.couchbase.env.timeouts.search

搜索服务的超时时间。

75s

spring.couchbase.env.timeouts.view

常规和地理空间视图操作的超时时间。

75s

spring.couchbase.password

集群密码。

spring.couchbase.username

集群用户名。

spring.dao.exceptiontranslation.enabled

是否启用 PersistenceExceptionTranslationPostProcessor。

true

spring.data.cassandra.repositories.type

要启用的 Cassandra 仓库类型。

auto

spring.data.couchbase.auto-index

自动创建视图和索引。使用 "@ViewIndexed"、"@N1qlPrimaryIndexed" 和 "@N1qlSecondaryIndexed" 提供的元数据。

false

spring.data.couchbase.bucket-name

要连接的桶名称。

spring.data.couchbase.field-naming-strategy

要使用的 FieldNamingStrategy 的完全限定名。

spring.data.couchbase.repositories.type

要启用的 Couchbase 仓库类型。

auto

spring.data.couchbase.scope-name

用于所有集合访问的 Scope 名称。

spring.data.couchbase.type-key

使用 "MappingCouchbaseConverter" 时,存储复杂类型信息的字段名称。

_class

spring.data.elasticsearch.repositories.enabled

是否启用 Elasticsearch 仓库。

true

spring.data.jdbc.dialect

要使用的方言。默认情况下,方言通过检查数据库连接来确定。

spring.data.jdbc.repositories.enabled

是否启用 JDBC 仓库。

true

spring.data.jpa.repositories.bootstrap-mode

JPA 仓库的引导模式。

default

spring.data.jpa.repositories.enabled

是否启用 JPA 仓库。

true

spring.data.ldap.repositories.enabled

是否启用 LDAP 仓库。

true

spring.data.mongodb.additional-hosts

其他服务器主机。如果设置了 'uri' 或省略了 'host',则忽略此设置。其他主机将使用默认的 MongoDB 端口 27017。如果想使用其他端口,可以使用 "host:port" 语法。

spring.data.mongodb.authentication-database

身份验证数据库名称。

spring.data.mongodb.auto-index-creation

是否启用自动创建索引。

spring.data.mongodb.database

数据库名称。覆盖 URI 中的数据库。

spring.data.mongodb.field-naming-strategy

要使用的 FieldNamingStrategy 的完全限定名。

spring.data.mongodb.gridfs.bucket

GridFS 桶名称。

spring.data.mongodb.gridfs.database

GridFS 数据库名称。

spring.data.mongodb.host

MongoDB 服务器主机。如果设置了 'uri',则忽略此设置。

spring.data.mongodb.password

MongoDB 服务器的登录密码。如果设置了 'uri',则忽略此设置。

spring.data.mongodb.port

MongoDB 服务器端口。如果设置了 'uri',则忽略此设置。

spring.data.mongodb.replica-set-name

集群所需的副本集名称。如果设置了 'uri',则忽略此设置。

spring.data.mongodb.repositories.type

要启用的 MongoDB 仓库类型。

auto

spring.data.mongodb.ssl.bundle

SSL bundle 名称。

spring.data.mongodb.ssl.enabled

是否启用 SSL 支持。除非另有说明,否则如果提供了 "bundle" 则自动启用。

spring.data.mongodb.uri

MongoDB 数据库 URI。覆盖 host、port、username 和 password。

mongodb://localhost/test

spring.data.mongodb.username

MongoDB 服务器的登录用户。如果设置了 'uri',则忽略此设置。

spring.data.mongodb.uuid-representation

将 UUID 转换为 BSON 二进制值时使用的表示形式。

java-legacy

spring.data.neo4j.database

要使用的数据库名称。默认情况下,服务器决定要使用的默认数据库。

spring.data.neo4j.repositories.type

要启用的 Neo4j 仓库类型。

auto

spring.data.r2dbc.repositories.enabled

是否启用 R2DBC 仓库。

true

spring.data.redis.client-name

通过 CLIENT SETNAME 在连接上设置的客户端名称。

spring.data.redis.client-type

要使用的客户端类型。默认情况下,根据 classpath 自动检测。

spring.data.redis.cluster.max-redirects

在集群中执行命令时,要遵循的最大重定向次数。

spring.data.redis.cluster.nodes

用于引导的 "host:port" 对列表。这表示集群节点的“初始”列表,且至少需要包含一个条目。

spring.data.redis.connect-timeout

连接超时。

spring.data.redis.database

连接工厂使用的数据库索引。

0

spring.data.redis.host

Redis 服务器主机。

localhost

spring.data.redis.jedis.pool.enabled

是否启用连接池。如果 "commons-pool2" 可用,则自动启用。对于 Jedis,在 Sentinel 模式下隐式启用池化,此设置仅适用于单节点配置。

spring.data.redis.jedis.pool.max-active

连接池在任何给定时间可分配的最大连接数。使用负值表示无限制。

8

spring.data.redis.jedis.pool.max-idle

池中“空闲”连接的最大数量。使用负值表示空闲连接数无限制。

8

spring.data.redis.jedis.pool.max-wait

当池耗尽时,连接分配在抛出异常之前应阻塞的最长时间。使用负值表示无限期阻塞。

-1ms

spring.data.redis.jedis.pool.min-idle

池中要维护的最小空闲连接数的目标。此设置仅在其值和逐出运行之间的间隔时间均为正时有效。

0

spring.data.redis.jedis.pool.time-between-eviction-runs

空闲对象逐出器线程运行之间的间隔时间。当值为正时,空闲对象逐出器线程启动,否则不执行空闲对象逐出。

spring.data.redis.lettuce.cluster.refresh.adaptive

是否应使用所有可用刷新触发器进行自适应拓扑刷新。

false

spring.data.redis.lettuce.cluster.refresh.dynamic-refresh-sources

是否发现并查询所有集群节点以获取集群拓扑。当设置为 false 时,仅使用初始种子节点作为拓扑发现的来源。

true

spring.data.redis.lettuce.cluster.refresh.period

集群拓扑刷新周期。

spring.data.redis.lettuce.pool.enabled

是否启用连接池。如果 "commons-pool2" 可用,则自动启用。对于 Jedis,在 Sentinel 模式下隐式启用池化,此设置仅适用于单节点配置。

spring.data.redis.lettuce.pool.max-active

连接池在任何给定时间可分配的最大连接数。使用负值表示无限制。

8

spring.data.redis.lettuce.pool.max-idle

池中“空闲”连接的最大数量。使用负值表示空闲连接数无限制。

8

spring.data.redis.lettuce.pool.max-wait

当池耗尽时,连接分配在抛出异常之前应阻塞的最长时间。使用负值表示无限期阻塞。

-1ms

spring.data.redis.lettuce.pool.min-idle

池中要维护的最小空闲连接数的目标。此设置仅在其值和逐出运行之间的间隔时间均为正时有效。

0

spring.data.redis.lettuce.pool.time-between-eviction-runs

空闲对象逐出器线程运行之间的间隔时间。当值为正时,空闲对象逐出器线程启动,否则不执行空闲对象逐出。

spring.data.redis.lettuce.shutdown-timeout

关闭超时。

100ms

spring.data.redis.password

Redis 服务器的登录密码。

spring.data.redis.port

Redis 服务器端口。

6379

spring.data.redis.repositories.enabled

是否启用 Redis 仓库。

true

spring.data.redis.sentinel.master

Redis 服务器名称。

spring.data.redis.sentinel.nodes

"host:port" 对列表。

spring.data.redis.sentinel.password

用于与 sentinel(s) 进行身份验证的密码。

spring.data.redis.sentinel.username

用于与 sentinel(s) 进行身份验证的登录用户名。

spring.data.redis.ssl.bundle

SSL bundle 名称。

spring.data.redis.ssl.enabled

是否启用 SSL 支持。除非另有说明,否则如果提供了 "bundle" 则自动启用。

spring.data.redis.timeout

读取超时。

spring.data.redis.url

连接 URL。覆盖 host、port、username 和 password。示例:redis://user:[email protected]:6379

spring.data.redis.username

Redis 服务器的登录用户名。

spring.data.rest.base-path

Spring Data REST 用于公开仓库资源的基础路径。

spring.data.rest.default-media-type

未指定时用作默认值的内容类型。

spring.data.rest.default-page-size

页面的默认大小。

spring.data.rest.detection-strategy

用于确定公开哪些仓库的策略。

default

spring.data.rest.enable-enum-translation

是否通过 Spring Data REST 默认资源包启用枚举值翻译。

spring.data.rest.limit-param-name

URL 查询字符串参数的名称,指示一次返回多少结果。

spring.data.rest.max-page-size

页面的最大大小。

spring.data.rest.page-param-name

URL 查询字符串参数的名称,指示返回哪一页。

spring.data.rest.return-body-on-create

创建实体后是否返回响应体。

spring.data.rest.return-body-on-update

更新实体后是否返回响应体。

spring.data.rest.sort-param-name

URL 查询字符串参数的名称,指示结果的排序方向。

spring.data.web.pageable.default-page-size

默认页大小。

20

spring.data.web.pageable.max-page-size

允许的最大页大小。

2000

spring.data.web.pageable.one-indexed-parameters

是否暴露并假定基于 1 的页码索引。默认为 "false",表示请求中的页码 0 等于第一页。

false

spring.data.web.pageable.page-parameter

页索引参数名称。

page

spring.data.web.pageable.prefix

添加到页码和页大小参数前的通用前缀。

spring.data.web.pageable.qualifier-delimiter

限定符与实际页码和页大小属性之间使用的分隔符。

_

spring.data.web.pageable.serialization-mode

配置如何渲染 Spring Data Pageable 实例。

direct

spring.data.web.pageable.size-parameter

页大小参数名称。

size

spring.data.web.sort.sort-parameter

排序参数名称。

sort

spring.datasource.dbcp2.abandoned-usage-tracking
spring.datasource.dbcp2.access-to-underlying-connection-allowed
spring.datasource.dbcp2.auto-commit-on-return
spring.datasource.dbcp2.cache-state
spring.datasource.dbcp2.clear-statement-pool-on-return
spring.datasource.dbcp2.connection-factory-class-name
spring.datasource.dbcp2.connection-init-sqls
spring.datasource.dbcp2.default-auto-commit
spring.datasource.dbcp2.default-catalog
spring.datasource.dbcp2.default-read-only
spring.datasource.dbcp2.default-schema
spring.datasource.dbcp2.default-transaction-isolation
spring.datasource.dbcp2.disconnection-sql-codes
spring.datasource.dbcp2.driver
spring.datasource.dbcp2.driver-class-name
spring.datasource.dbcp2.duration-between-eviction-runs
spring.datasource.dbcp2.eviction-policy-class-name
spring.datasource.dbcp2.fast-fail-validation
spring.datasource.dbcp2.initial-size
spring.datasource.dbcp2.jmx-name
spring.datasource.dbcp2.lifo
spring.datasource.dbcp2.log-abandoned
spring.datasource.dbcp2.log-expired-connections
spring.datasource.dbcp2.login-timeout
spring.datasource.dbcp2.max-idle
spring.datasource.dbcp2.max-open-prepared-statements
spring.datasource.dbcp2.max-total
spring.datasource.dbcp2.min-idle
spring.datasource.dbcp2.num-tests-per-eviction-run
spring.datasource.dbcp2.password
spring.datasource.dbcp2.pool-prepared-statements
spring.datasource.dbcp2.remove-abandoned-on-borrow
spring.datasource.dbcp2.remove-abandoned-on-maintenance
spring.datasource.dbcp2.rollback-on-return
spring.datasource.dbcp2.test-on-borrow
spring.datasource.dbcp2.test-on-create
spring.datasource.dbcp2.test-on-return
spring.datasource.dbcp2.test-while-idle
spring.datasource.dbcp2.url
spring.datasource.dbcp2.username
spring.datasource.dbcp2.validation-query

绑定到 DBCP2 BasicDataSource 实例的 Commons DBCP2 特定设置

spring.datasource.driver-class-name

JDBC 驱动程序的完全限定名。默认情况下根据 URL 自动检测。

spring.datasource.embedded-database-connection

内嵌数据库的连接详情。默认为 classpath 中最适合的内嵌数据库。

spring.datasource.generate-unique-name

是否生成随机的数据源名称。

true

spring.datasource.hikari.allow-pool-suspension
spring.datasource.hikari.auto-commit
spring.datasource.hikari.catalog
spring.datasource.hikari.connection-init-sql
spring.datasource.hikari.connection-test-query
spring.datasource.hikari.connection-timeout
spring.datasource.hikari.data-source-class-name
spring.datasource.hikari.data-source-j-n-d-i
spring.datasource.hikari.data-source-properties
spring.datasource.hikari.driver-class-name
spring.datasource.hikari.exception-override-class-name
spring.datasource.hikari.health-check-properties
spring.datasource.hikari.idle-timeout
spring.datasource.hikari.initialization-fail-timeout
spring.datasource.hikari.isolate-internal-queries
spring.datasource.hikari.jdbc-url
spring.datasource.hikari.keepalive-time
spring.datasource.hikari.leak-detection-threshold
spring.datasource.hikari.login-timeout
spring.datasource.hikari.max-lifetime
spring.datasource.hikari.maximum-pool-size
spring.datasource.hikari.metrics-tracker-factory
spring.datasource.hikari.minimum-idle
spring.datasource.hikari.password
spring.datasource.hikari.pool-name
spring.datasource.hikari.read-only
spring.datasource.hikari.register-mbeans
spring.datasource.hikari.scheduled-executor
spring.datasource.hikari.schema
spring.datasource.hikari.transaction-isolation
spring.datasource.hikari.username
spring.datasource.hikari.validation-timeout

绑定到 Hikari HikariDataSource 实例的 Hikari 特定设置

spring.datasource.jndi-name

数据源的 JNDI 位置。设置后,class、url、username 和 password 将被忽略。

spring.datasource.name

如果 "generate-unique-name" 为 false,则使用的数据源名称。使用内嵌数据库时默认为 "testdb",否则为 null。

spring.datasource.oracleucp.abandoned-connection-timeout
spring.datasource.oracleucp.connection-factory-class-name
spring.datasource.oracleucp.connection-factory-properties
spring.datasource.oracleucp.connection-harvest-max-count
spring.datasource.oracleucp.connection-harvest-trigger-count
spring.datasource.oracleucp.connection-labeling-high-cost
spring.datasource.oracleucp.connection-pool-name
spring.datasource.oracleucp.connection-properties
spring.datasource.oracleucp.connection-repurpose-threshold
spring.datasource.oracleucp.connection-validation-timeout
spring.datasource.oracleucp.connection-wait-duration
spring.datasource.oracleucp.connection-wait-duration-in-millis
spring.datasource.oracleucp.create-connection-in-borrow-thread
spring.datasource.oracleucp.data-source-name
spring.datasource.oracleucp.database-name
spring.datasource.oracleucp.description
spring.datasource.oracleucp.fast-connection-failover-enabled
spring.datasource.oracleucp.high-cost-connection-reuse-threshold
spring.datasource.oracleucp.hostname-resolver
spring.datasource.oracleucp.inactive-connection-timeout
spring.datasource.oracleucp.initial-pool-size
spring.datasource.oracleucp.login-timeout
spring.datasource.oracleucp.max-connection-reuse-count
spring.datasource.oracleucp.max-connection-reuse-time
spring.datasource.oracleucp.max-connections-per-shard
spring.datasource.oracleucp.max-idle-time
spring.datasource.oracleucp.max-pool-size
spring.datasource.oracleucp.max-statements
spring.datasource.oracleucp.min-idle
spring.datasource.oracleucp.min-pool-size
spring.datasource.oracleucp.network-protocol
spring.datasource.oracleucp.o-n-s-configuration
spring.datasource.oracleucp.pdb-roles
spring.datasource.oracleucp.port-number
spring.datasource.oracleucp.property-cycle
spring.datasource.oracleucp.query-timeout
spring.datasource.oracleucp.read-only-instance-allowed
spring.datasource.oracleucp.role-name
spring.datasource.oracleucp.s-q-l-for-validate-connection
spring.datasource.oracleucp.seconds-to-trust-idle-connection
spring.datasource.oracleucp.server-name
spring.datasource.oracleucp.sharding-mode
spring.datasource.oracleucp.time-to-live-connection-timeout
spring.datasource.oracleucp.timeout-check-interval
spring.datasource.oracleucp.u-r-l
spring.datasource.oracleucp.user
spring.datasource.oracleucp.validate-connection-on-borrow

绑定到 Oracle UCP PoolDataSource 实例的 Oracle UCP 特定设置

spring.datasource.password

数据库登录密码。

spring.datasource.tomcat.abandon-when-percentage-full
spring.datasource.tomcat.access-to-underlying-connection-allowed
spring.datasource.tomcat.alternate-username-allowed
spring.datasource.tomcat.commit-on-return
spring.datasource.tomcat.connection-properties
spring.datasource.tomcat.data-source-j-n-d-i
spring.datasource.tomcat.db-properties
spring.datasource.tomcat.default-auto-commit
spring.datasource.tomcat.default-catalog
spring.datasource.tomcat.default-read-only
spring.datasource.tomcat.default-transaction-isolation
spring.datasource.tomcat.driver-class-name
spring.datasource.tomcat.fair-queue
spring.datasource.tomcat.ignore-exception-on-pre-load
spring.datasource.tomcat.init-s-q-l
spring.datasource.tomcat.initial-size
spring.datasource.tomcat.jdbc-interceptors
spring.datasource.tomcat.jmx-enabled
spring.datasource.tomcat.log-abandoned
spring.datasource.tomcat.log-validation-errors
spring.datasource.tomcat.login-timeout
spring.datasource.tomcat.max-active
spring.datasource.tomcat.max-age
spring.datasource.tomcat.max-idle
spring.datasource.tomcat.max-wait
spring.datasource.tomcat.min-evictable-idle-time-millis
spring.datasource.tomcat.min-idle
spring.datasource.tomcat.name
spring.datasource.tomcat.num-tests-per-eviction-run
spring.datasource.tomcat.password
spring.datasource.tomcat.propagate-interrupt-state
spring.datasource.tomcat.remove-abandoned
spring.datasource.tomcat.remove-abandoned-timeout
spring.datasource.tomcat.rollback-on-return
spring.datasource.tomcat.suspect-timeout
spring.datasource.tomcat.test-on-borrow
spring.datasource.tomcat.test-on-connect
spring.datasource.tomcat.test-on-return
spring.datasource.tomcat.test-while-idle
spring.datasource.tomcat.time-between-eviction-runs-millis
spring.datasource.tomcat.url
spring.datasource.tomcat.use-disposable-connection-facade
spring.datasource.tomcat.use-equals
spring.datasource.tomcat.use-lock
spring.datasource.tomcat.use-statement-facade
spring.datasource.tomcat.username
spring.datasource.tomcat.validation-interval
spring.datasource.tomcat.validation-query
spring.datasource.tomcat.validation-query-timeout
spring.datasource.tomcat.validator-class-name

绑定到 Tomcat JDBC DataSource 实例的 Tomcat 数据源特定设置

spring.datasource.type

要使用的数据源实现的完全限定名。默认情况下,从 classpath 自动检测连接池实现。

spring.datasource.url

数据库的 JDBC URL。

spring.datasource.username

数据库登录用户名。

spring.datasource.xa.data-source-class-name

XA 数据源的完全限定名。

spring.datasource.xa.properties.*

传递给 XA 数据源的属性。

spring.elasticsearch.connection-timeout

与 Elasticsearch 通信时使用的连接超时。

1s

spring.elasticsearch.password

与 Elasticsearch 进行身份验证的密码。

spring.elasticsearch.path-prefix

添加到发送到 Elasticsearch 的每个请求路径的前缀。

spring.elasticsearch.restclient.sniffer.delay-after-failure

失败后安排的嗅探执行的延迟。

1m

spring.elasticsearch.restclient.sniffer.interval

连续普通嗅探执行之间的间隔。

5m

spring.elasticsearch.restclient.ssl.bundle

SSL bundle 名称。

spring.elasticsearch.socket-keep-alive

是否启用客户端与 Elasticsearch 之间的 socket keep alive。

false

spring.elasticsearch.socket-timeout

与 Elasticsearch 通信时使用的 socket 超时。

30s

spring.elasticsearch.uris

要使用的 Elasticsearch 实例列表。

[http://localhost:9200]

spring.elasticsearch.username

与 Elasticsearch 进行身份验证的用户名。

spring.h2.console.enabled

是否启用控制台。

false

spring.h2.console.path

控制台可用的路径。

/h2-console

spring.h2.console.settings.trace

是否启用跟踪输出。

false

spring.h2.console.settings.web-admin-password

访问 H2 控制台首选项和工具的密码。

spring.h2.console.settings.web-allow-others

是否启用远程访问。

false

spring.jdbc.template.fetch-size

需要更多行时应从数据库中获取的行数。使用 -1 表示使用 JDBC 驱动程序的默认配置。

-1

spring.jdbc.template.max-rows

最大行数。使用 -1 表示使用 JDBC 驱动程序的默认配置。

-1

spring.jdbc.template.query-timeout

查询超时。默认使用 JDBC 驱动程序的默认配置。如果未指定持续时间后缀,则使用秒作为单位。

spring.jooq.sql-dialect

要使用的 SQL 方言。默认自动检测。

spring.jpa.database

要操作的目标数据库,默认自动检测。也可以使用 "databasePlatform" 属性进行设置。

spring.jpa.database-platform

要操作的目标数据库名称,默认自动检测。也可以使用 "Database" 枚举进行设置。

spring.jpa.defer-datasource-initialization

是否推迟 DataSource 初始化,直到所有 EntityManagerFactory bean 都已创建和初始化之后。

false

spring.jpa.generate-ddl

是否在启动时初始化模式。

false

spring.jpa.hibernate.ddl-auto

DDL 模式。这实际上是 "hibernate.hbm2ddl.auto" 属性的一个快捷方式。在使用嵌入式数据库且未检测到模式管理器时,默认值为 "create-drop"。否则,默认值为 "none"。

spring.jpa.hibernate.naming.implicit-strategy

隐式命名策略的完全限定名。

spring.jpa.hibernate.naming.physical-strategy

物理命名策略的完全限定名。

spring.jpa.mapping-resources

映射资源(相当于 persistence.xml 中的 "mapping-file" 条目)。

spring.jpa.open-in-view

注册 OpenEntityManagerInViewInterceptor。将 JPA EntityManager 绑定到线程,用于整个请求处理过程。

true

spring.jpa.properties.*

要设置在 JPA 提供程序上的额外原生属性。

spring.jpa.show-sql

是否启用 SQL 语句的日志记录。

false

spring.ldap.anonymous-read-only

只读操作是否应使用匿名环境。除非设置了用户名,否则默认禁用。

spring.ldap.base

所有操作应起源的基础后缀。

spring.ldap.base-environment.*

LDAP 规范设置。

spring.ldap.embedded.base-dn

基本 DN 列表。

spring.ldap.embedded.credential.password

嵌入式 LDAP 密码。

spring.ldap.embedded.credential.username

嵌入式 LDAP 用户名。

spring.ldap.embedded.ldif

模式 (LDIF) 脚本资源引用。

classpath:schema.ldif

spring.ldap.embedded.port

嵌入式 LDAP 端口。

0

spring.ldap.embedded.validation.enabled

是否启用 LDAP 模式验证。

true

spring.ldap.embedded.validation.schema

自定义模式的路径。

spring.ldap.password

服务器的登录密码。

spring.ldap.template.ignore-name-not-found-exception

是否在通过 LdapTemplate 进行搜索时忽略 NameNotFoundException。

false

spring.ldap.template.ignore-partial-result-exception

是否在通过 LdapTemplate 进行搜索时忽略 PartialResultException。

false

spring.ldap.template.ignore-size-limit-exceeded-exception

是否在通过 LdapTemplate 进行搜索时忽略 SizeLimitExceededException。

true

spring.ldap.urls

服务器的 LDAP URL。

spring.ldap.username

服务器的登录用户名。

spring.neo4j.authentication.kerberos-ticket

用于连接数据库的 Kerberos 票据。与给定的用户名互斥。

spring.neo4j.authentication.password

服务器的登录密码。

spring.neo4j.authentication.realm

要连接的领域 (Realm)。

spring.neo4j.authentication.username

服务器的登录用户。

spring.neo4j.connection-timeout

从连接池借用连接的超时时间。

30s

spring.neo4j.max-transaction-retry-time

事务允许重试的最大时间。

30s

spring.neo4j.pool.connection-acquisition-timeout

获取新连接最多尝试配置的超时时间。

60s

spring.neo4j.pool.idle-time-before-connection-test

在连接池中空闲时间超过此阈值的池化连接,在使用前将进行测试。

spring.neo4j.pool.log-leaked-sessions

是否记录泄漏的会话。

false

spring.neo4j.pool.max-connection-lifetime

超过此阈值的池化连接将被关闭并从池中移除。

1h

spring.neo4j.pool.max-connection-pool-size

连接池中针对单个数据库的最大连接数。

100

spring.neo4j.pool.metrics-enabled

是否启用指标。

false

spring.neo4j.security.cert-file

包含受信任证书的文件路径。

spring.neo4j.security.encrypted

驱动程序是否应使用加密流量。

false

spring.neo4j.security.hostname-verification-enabled

是否需要进行主机名验证。

true

spring.neo4j.security.trust-strategy

要使用的信任策略。

trust-system-ca-signed-certificates

spring.neo4j.uri

驱动程序使用的 URI。

bolt://localhost:7687

spring.r2dbc.generate-unique-name

是否生成随机数据库名称。启用时忽略任何配置的名称。

false

spring.r2dbc.name

数据库名称。如果在 URL 中未指定名称,则设置此项。使用嵌入式数据库时,默认值为 "testdb"。

spring.r2dbc.password

数据库的登录密码。如果在 URL 中未指定密码,则设置此项。

spring.r2dbc.pool.enabled

是否启用连接池。需要 r2dbc-pool。

true

spring.r2dbc.pool.initial-size

初始连接池大小。

10

spring.r2dbc.pool.max-acquire-time

从连接池获取连接的最大时间。默认情况下,无限期等待。

spring.r2dbc.pool.max-create-connection-time

等待创建新连接的最大时间。默认情况下,无限期等待。

spring.r2dbc.pool.max-idle-time

连接在池中允许处于空闲状态的最长时间。

30m

spring.r2dbc.pool.max-life-time

连接在池中的最大生命周期。默认情况下,连接具有无限生命周期。

spring.r2dbc.pool.max-size

最大连接池大小。

10

spring.r2dbc.pool.max-validation-time

验证连接池中连接的最大时间。默认情况下,无限期等待。

spring.r2dbc.pool.min-idle

最小空闲连接数。

0

spring.r2dbc.pool.validation-depth

验证深度。

local

spring.r2dbc.pool.validation-query

验证查询。

spring.r2dbc.properties.*

额外的 R2DBC 选项。

spring.r2dbc.url

数据库的 R2DBC URL。URL 中指定的数据库名称、用户名、密码和连接池选项优先于单独的选项。

spring.r2dbc.username

数据库的登录用户名。如果在 URL 中未指定用户名,则设置此项。

Devtools 属性

名称 描述 默认值

spring.devtools.add-properties

是否启用开发属性默认值。

true

spring.devtools.livereload.enabled

是否启用兼容 livereload.com 的服务器。

true

spring.devtools.livereload.port

服务器端口。

35729

spring.devtools.remote.context-path

用于处理远程连接的上下文路径。

/.~~spring-boot!~

spring.devtools.remote.proxy.host

用于连接远程应用的代理主机。

spring.devtools.remote.proxy.port

用于连接远程应用的代理端口。

spring.devtools.remote.restart.enabled

是否启用远程重启。

true

spring.devtools.remote.secret

建立连接所需的共享密钥(启用远程支持所需)。

spring.devtools.remote.secret-header-name

用于传输共享密钥的 HTTP 头。

X-AUTH-TOKEN

spring.devtools.restart.additional-exclude

应排除在触发完全重启之外的额外模式。

spring.devtools.restart.additional-paths

要监视变更的额外路径。

spring.devtools.restart.enabled

是否启用自动重启。

true

spring.devtools.restart.exclude

应排除在触发完全重启之外的模式。

META-INF/maven/**,META-INF/resources/**,resources/**,static/**,public/**,templates/**,**/*Test.class,**/*Tests.class,git.properties,META-INF/build-info.properties

spring.devtools.restart.log-condition-evaluation-delta

是否在重启时记录条件评估增量。

true

spring.devtools.restart.poll-interval

轮询类路径更改之间的等待时间。

1s

spring.devtools.restart.quiet-period

触发重启前,需要没有类路径更改的静默时间。

400ms

spring.devtools.restart.trigger-file

更改时触发重启检查的特定文件名称。必须是类路径中文件的简单名称(不包含任何路径)。如果未指定,则任何类路径文件更改都会触发重启。

Docker Compose 属性

名称 描述 默认值

spring.docker.compose.arguments

要传递给 Docker Compose 命令的参数。

spring.docker.compose.enabled

是否启用 Docker Compose 支持。

true

spring.docker.compose.file

Docker Compose 配置文件的路径。

spring.docker.compose.host

启动 Docker 容器的机器的主机名或 IP。

spring.docker.compose.lifecycle-management

Docker Compose 生命周期管理。

start-and-stop

spring.docker.compose.profiles.active

应激活的 Docker Compose profile。

spring.docker.compose.readiness.tcp.connect-timeout

连接超时时间。

200ms

spring.docker.compose.readiness.tcp.read-timeout

读取超时时间。

200ms

spring.docker.compose.readiness.timeout

就绪检查的超时时间。

2m

spring.docker.compose.readiness.wait

要使用的等待策略。

always

spring.docker.compose.skip.in-tests

是否在测试中跳过。

true

spring.docker.compose.start.arguments

要传递给启动命令的参数。

spring.docker.compose.start.command

用于启动 Docker Compose 的命令。

up

spring.docker.compose.start.log-level

输出的日志级别。

info

spring.docker.compose.start.skip

是否跳过执行启动命令。

if-running

spring.docker.compose.stop.arguments

要传递给停止命令的参数。

spring.docker.compose.stop.command

用于停止 Docker Compose 的命令。

stop

spring.docker.compose.stop.timeout

停止 Docker Compose 的超时时间。使用 '0' 进行强制停止。

10s

集成属性

名称 描述 默认值

spring.activemq.broker-url

ActiveMQ 消息代理的 URL。默认自动生成。

spring.activemq.close-timeout

等待时间,在此之后视为关闭完成。

15s

spring.activemq.embedded.enabled

如果 ActiveMQ 消息代理可用,是否启用嵌入式模式。

true

spring.activemq.non-blocking-redelivery

是否在重新投递回滚事务中的消息之前停止消息投递。这意味着启用此功能时,消息顺序不会保留。

false

spring.activemq.packages.trust-all

是否信任所有包。

spring.activemq.packages.trusted

要信任的特定包列表(未信任所有包时)。

spring.activemq.password

消息代理的登录密码。

spring.activemq.pool.block-if-full

当请求连接且池已满时是否阻塞。将其设置为 false 以抛出 "JMSException"。

true

spring.activemq.pool.block-if-full-timeout

如果连接池仍然已满,抛出异常前的阻塞时长。

-1ms

spring.activemq.pool.enabled

是否创建 JmsPoolConnectionFactory 而非常规的 ConnectionFactory。

false

spring.activemq.pool.idle-timeout

连接空闲超时时间。

30s

spring.activemq.pool.max-connections

最大池化连接数。

1

spring.activemq.pool.max-sessions-per-connection

池中每个连接的最大池化会话数。

500

spring.activemq.pool.time-between-expiration-check

空闲连接逐出线程运行之间的休眠时间。当为负数时,不会运行空闲连接逐出线程。

-1ms

spring.activemq.pool.use-anonymous-producers

是否只使用一个匿名的 "MessageProducer" 实例。将其设置为 false,则在每次需要时创建一个 "MessageProducer"。

true

spring.activemq.send-timeout

发送消息后等待响应的时间。设置为 0 表示无限期等待。

0ms

spring.activemq.user

消息代理的登录用户。

spring.artemis.broker-url

Artemis 消息代理 URL。

tcp://localhost:61616

spring.artemis.embedded.cluster-password

集群密码。默认在启动时随机生成。

spring.artemis.embedded.data-directory

日志文件目录。如果关闭持久化,则不需要此项。

spring.artemis.embedded.enabled

如果 Artemis 服务器 API 可用,是否启用嵌入式模式。

true

spring.artemis.embedded.persistent

是否启用持久化存储。

false

spring.artemis.embedded.queues

启动时要创建的队列列表。

[]

spring.artemis.embedded.server-id

服务器 ID。默认使用自增计数器。

0

spring.artemis.embedded.topics

启动时要创建的主题列表。

[]

spring.artemis.mode

Artemis 部署模式,默认自动检测。

spring.artemis.password

消息代理的登录密码。

spring.artemis.pool.block-if-full

当请求连接且池已满时是否阻塞。将其设置为 false 以抛出 "JMSException"。

true

spring.artemis.pool.block-if-full-timeout

如果连接池仍然已满,抛出异常前的阻塞时长。

-1ms

spring.artemis.pool.enabled

是否创建 JmsPoolConnectionFactory 而非常规的 ConnectionFactory。

false

spring.artemis.pool.idle-timeout

连接空闲超时时间。

30s

spring.artemis.pool.max-connections

最大池化连接数。

1

spring.artemis.pool.max-sessions-per-connection

池中每个连接的最大池化会话数。

500

spring.artemis.pool.time-between-expiration-check

空闲连接逐出线程运行之间的休眠时间。当为负数时,不会运行空闲连接逐出线程。

-1ms

spring.artemis.pool.use-anonymous-producers

是否只使用一个匿名的 "MessageProducer" 实例。将其设置为 false,则在每次需要时创建一个 "MessageProducer"。

true

spring.artemis.user

消息代理的登录用户。

spring.batch.jdbc.initialize-schema

数据库 schema 初始化模式。

embedded

spring.batch.jdbc.isolation-level-for-create

为新作业创建作业元数据时要使用的事务隔离级别。

spring.batch.jdbc.platform

如果在初始化脚本中使用了 @@platform@@ 占位符,则使用此平台。默认自动检测。

spring.batch.jdbc.schema

用于初始化数据库 schema 的 SQL 文件路径。

classpath:org/springframework/batch/core/schema-@@platform@@.sql

spring.batch.jdbc.table-prefix

所有批处理元数据表的表前缀。

spring.batch.job.enabled

在启动时执行上下文中的所有 Spring Batch 作业。

true

spring.batch.job.name

启动时要执行的作业名称。如果在上下文中找到多个作业,则必须指定此项。

spring.hazelcast.config

用于初始化 Hazelcast 的配置文件的位置。

spring.integration.channel.auto-create

是否在必要时创建输入通道。

true

spring.integration.channel.max-broadcast-subscribers

例如,'PublishSubscribeChannel' 允许的默认订阅者数量。

spring.integration.channel.max-unicast-subscribers

例如,'DirectChannel' 允许的默认订阅者数量。

spring.integration.endpoint.default-timeout

发送或接收消息等阻塞操作的默认超时时间。

30s

spring.integration.endpoint.no-auto-startup

不应在应用启动时自动启动的端点 bean 名称模式列表。

spring.integration.endpoint.read-only-headers

在头复制操作期间不应填充到 Message 实例中的消息头名称列表。

spring.integration.endpoint.throw-exception-on-late-reply

当网关不再期望回复时是否抛出异常。

false

spring.integration.error.ignore-failures

是否忽略全局 'errorChannel' 的一个或多个处理程序的故障。

true

spring.integration.error.require-subscribers

当没有订阅者时,是否不静默忽略全局 'errorChannel' 上的消息。

true

spring.integration.jdbc.initialize-schema

数据库 schema 初始化模式。

embedded

spring.integration.jdbc.platform

如果在初始化脚本中使用了 @@platform@@ 占位符,则使用此平台。默认自动检测。

spring.integration.jdbc.schema

用于初始化数据库 schema 的 SQL 文件路径。

classpath:org/springframework/integration/jdbc/schema-@@platform@@.sql

spring.integration.management.default-logging-enabled

Spring Integration 组件是否应在主消息流中执行日志记录。禁用时,将跳过此类日志记录,而不检查日志记录级别。启用时,此类日志记录像正常一样由日志系统日志级别配置控制。

true

spring.integration.management.observation-patterns

用于匹配 Spring Integration 组件名称的简单模式列表。匹配时,将对该组件执行观测仪表化。有关模式语法的详细信息,请参阅 Spring Integration 的 PatternMatchUtils 的 smartMatch 方法的 javadoc。

spring.integration.poller.cron

轮询的 Cron 表达式。与 'fixedDelay' 和 'fixedRate' 互斥。

spring.integration.poller.fixed-delay

轮询延迟周期。与 'cron' 和 'fixedRate' 互斥。

spring.integration.poller.fixed-rate

轮询速率周期。与 'fixedDelay' 和 'cron' 互斥。

spring.integration.poller.initial-delay

轮询初始延迟。应用于 'fixedDelay' 和 'fixedRate';对 'cron' 忽略。

spring.integration.poller.max-messages-per-poll

每个轮询周期最多轮询的消息数。

spring.integration.poller.receive-timeout

轮询时等待消息的时间。

1s

spring.integration.rsocket.client.host

要连接的 TCP RSocket 服务器主机。

spring.integration.rsocket.client.port

要连接的 TCP RSocket 服务器端口。

spring.integration.rsocket.client.uri

要连接的 WebSocket RSocket 服务器 URI。

spring.integration.rsocket.server.message-mapping-enabled

是否通过 Spring Integration 处理 RSocket 的消息映射。

false

spring.jms.cache.consumers

是否缓存消息消费者。

false

spring.jms.cache.enabled

是否缓存会话。

true

spring.jms.cache.producers

是否缓存消息生产者。

true

spring.jms.cache.session-cache-size

会话缓存的大小(每个 JMS 会话类型)。

1

spring.jms.client-id

连接的客户端 ID。

spring.jms.jndi-name

连接工厂 JNDI 名称。设置后,优先于其他连接工厂自动配置。

spring.jms.listener.auto-startup

启动时是否自动启动容器。

true

spring.jms.listener.max-concurrency

并发消费者的最大数量。

spring.jms.listener.max-messages-per-task

单个任务中处理的最大消息数。默认情况下,除非监听器上配置了 SchedulingTaskExecutor(10 条消息),否则无限制,因为它表明更倾向于短生命周期的任务。

spring.jms.listener.min-concurrency

并发消费者的最小数量。未指定 max-concurrency 时,最小数量也将用作最大数量。

spring.jms.listener.receive-timeout

用于 receive 调用的超时时间。使用 -1 表示非等待接收,使用 0 表示完全没有超时。后者仅在未在事务管理器中运行时可行,并且通常不鼓励使用,因为它会阻止干净关闭。

1s

spring.jms.listener.session.acknowledge-mode

监听器容器的确认模式。

auto

spring.jms.listener.session.transacted

监听器容器是否应使用事务性 JMS 会话。存在 JtaTransactionManager 时默认为 false,否则为 true。

spring.jms.pub-sub-domain

默认目标类型是否为 topic。

false

spring.jms.subscription-durable

订阅是否持久化。

false

spring.jms.template.default-destination

在没有目标参数的发送和接收操作中使用的默认目标。

spring.jms.template.delivery-delay

发送调用使用的交付延迟。

spring.jms.template.delivery-mode

交付模式。设置时启用 QoS (Quality of Service)。

spring.jms.template.priority

发送消息时的优先级。设置时启用 QoS (Quality of Service)。

spring.jms.template.qos-enabled

发送消息时是否启用显式 QoS (Quality of Service)。启用后,发送消息时将使用交付模式、优先级和存活时间属性。当至少一个设置被自定义时,QoS 会自动启用。

spring.jms.template.receive-timeout

用于 receive 调用的超时时间。

spring.jms.template.session.acknowledge-mode

创建会话时使用的确认模式。

auto

spring.jms.template.session.transacted

是否使用事务性会话。

false

spring.jms.template.time-to-live

发送消息时的存活时间。设置时启用 QoS (Quality of Service)。

spring.kafka.admin.auto-create

上下文初始化期间是否自动创建主题。设置为 false 时,禁用上下文初始化期间的自动主题创建。

true

spring.kafka.admin.client-id

发出请求时传递给服务器的 ID。用于服务器端日志记录。

spring.kafka.admin.close-timeout

关闭超时。

spring.kafka.admin.fail-fast

启动时如果 broker 不可用是否快速失败。

false

spring.kafka.admin.modify-topic-configs

是否启用修改现有主题配置。

false

spring.kafka.admin.operation-timeout

操作超时。

spring.kafka.admin.properties.*

用于配置客户端的额外 admin 特定属性。

spring.kafka.admin.security.protocol

与 broker 通信使用的安全协议。

spring.kafka.admin.ssl.bundle

要使用的 SSL 捆绑包名称。

spring.kafka.admin.ssl.key-password

密钥库密钥或密钥库文件中的私钥密码。

spring.kafka.admin.ssl.key-store-certificate-chain

PEM 格式的证书链,包含 X.509 证书列表。

spring.kafka.admin.ssl.key-store-key

PEM 格式的私钥,包含 PKCS#8 密钥。

spring.kafka.admin.ssl.key-store-location

密钥库文件位置。

spring.kafka.admin.ssl.key-store-password

密钥库文件的存储密码。

spring.kafka.admin.ssl.key-store-type

密钥库类型。

spring.kafka.admin.ssl.protocol

要使用的 SSL 协议。

spring.kafka.admin.ssl.trust-store-certificates

PEM 格式的受信任证书,包含 X.509 证书。

spring.kafka.admin.ssl.trust-store-location

信任库文件位置。

spring.kafka.admin.ssl.trust-store-password

信任库文件的存储密码。

spring.kafka.admin.ssl.trust-store-type

信任库类型。

spring.kafka.bootstrap-servers

用于与 Kafka 集群建立初始连接的主机:端口对列表。除非被覆盖,否则适用于所有组件。

spring.kafka.client-id

发出请求时传递给服务器的 ID。用于服务器端日志记录。

spring.kafka.consumer.auto-commit-interval

如果 'enable.auto.commit' 设置为 true,消费者偏移量自动提交到 Kafka 的频率。

spring.kafka.consumer.auto-offset-reset

当 Kafka 中没有初始偏移量或当前偏移量不再存在于服务器上时该怎么做。

spring.kafka.consumer.bootstrap-servers

用于与 Kafka 集群建立初始连接的主机:端口对列表。对于消费者,它会覆盖全局属性。

spring.kafka.consumer.client-id

发出请求时传递给服务器的 ID。用于服务器端日志记录。

spring.kafka.consumer.enable-auto-commit

消费者的偏移量是否在后台定期提交。

spring.kafka.consumer.fetch-max-wait

如果在给定的 "fetch-min-size" 要求下没有足够的数据立即满足 fetch 请求,服务器在响应请求前阻塞的最长时间。

spring.kafka.consumer.fetch-min-size

服务器应为 fetch 请求返回的最小数据量。

spring.kafka.consumer.group-id

标识该消费者所属消费者组的唯一字符串。

spring.kafka.consumer.heartbeat-interval

发送给消费者协调器心跳之间的预期时间。

spring.kafka.consumer.isolation-level

读取事务性写入的消息的隔离级别。

read-uncommitted

spring.kafka.consumer.key-deserializer

键的反序列化器类。

spring.kafka.consumer.max-poll-records

一次调用 poll() 返回的最大记录数。

spring.kafka.consumer.properties.*

用于配置客户端的额外 consumer 特定属性。

spring.kafka.consumer.security.protocol

与 broker 通信使用的安全协议。

spring.kafka.consumer.ssl.bundle

要使用的 SSL 捆绑包名称。

spring.kafka.consumer.ssl.key-password

密钥库密钥或密钥库文件中的私钥密码。

spring.kafka.consumer.ssl.key-store-certificate-chain

PEM 格式的证书链,包含 X.509 证书列表。

spring.kafka.consumer.ssl.key-store-key

PEM 格式的私钥,包含 PKCS#8 密钥。

spring.kafka.consumer.ssl.key-store-location

密钥库文件位置。

spring.kafka.consumer.ssl.key-store-password

密钥库文件的存储密码。

spring.kafka.consumer.ssl.key-store-type

密钥库类型。

spring.kafka.consumer.ssl.protocol

要使用的 SSL 协议。

spring.kafka.consumer.ssl.trust-store-certificates

PEM 格式的受信任证书,包含 X.509 证书。

spring.kafka.consumer.ssl.trust-store-location

信任库文件位置。

spring.kafka.consumer.ssl.trust-store-password

信任库文件的存储密码。

spring.kafka.consumer.ssl.trust-store-type

信任库类型。

spring.kafka.consumer.value-deserializer

值的反序列化器类。

spring.kafka.jaas.control-flag

登录配置的控制标志。

required

spring.kafka.jaas.enabled

是否启用 JAAS 配置。

false

spring.kafka.jaas.login-module

登录模块。

com.sun.security.auth.module.Krb5LoginModule

spring.kafka.jaas.options.*

额外的 JAAS 选项。

spring.kafka.listener.ack-count

ackMode 为 "COUNT" 或 "COUNT_TIME" 时,偏移量提交之间的记录数。

spring.kafka.listener.ack-mode

监听器 AckMode。请参阅 spring-kafka 文档。

spring.kafka.listener.ack-time

ackMode 为 "TIME" 或 "COUNT_TIME" 时,偏移量提交之间的时间。

spring.kafka.listener.async-acks

支持异步记录确认。仅适用于 spring.kafka.listener.ack-mode 为 manual 或 manual-immediate。

spring.kafka.listener.auto-startup

是否自动启动容器。

true

spring.kafka.listener.change-consumer-thread-name

是否指示容器在初始化期间更改消费者线程名称。

spring.kafka.listener.client-id

监听器消费者 client.id 属性的前缀。

spring.kafka.listener.concurrency

监听器容器中运行的线程数。

spring.kafka.listener.idle-between-polls

Consumer.poll(Duration) 调用之间的睡眠间隔。

0

spring.kafka.listener.idle-event-interval

发布空闲消费者事件(未接收到数据)之间的时间。

spring.kafka.listener.idle-partition-event-interval

发布空闲分区消费者事件(分区未接收到数据)之间的时间。

spring.kafka.listener.immediate-stop

容器是在处理完当前记录后停止还是在处理完上次 poll 的所有记录后停止。

false

spring.kafka.listener.log-container-config

初始化期间是否记录容器配置(INFO 级别)。

spring.kafka.listener.missing-topics-fatal

如果至少一个配置的主题在 broker 上不存在,容器启动是否失败。

false

spring.kafka.listener.monitor-interval

检查无响应消费者之间的时间。如果未指定 duration 后缀,将使用秒。

spring.kafka.listener.no-poll-threshold

应用于 "pollTimeout" 以确定消费者是否无响应的乘数。

spring.kafka.listener.observation-enabled

是否启用观测。

false

spring.kafka.listener.poll-timeout

轮询消费者时使用的超时时间。

spring.kafka.listener.type

监听器类型。

single

spring.kafka.producer.acks

生产者要求 leader 在认为请求完成之前收到的确认数。

spring.kafka.producer.batch-size

默认批处理大小。较小的批处理大小会使批处理不那么常见,并可能降低吞吐量(批处理大小为零会完全禁用批处理)。

spring.kafka.producer.bootstrap-servers

用于与 Kafka 集群建立初始连接的主机:端口对列表。对于生产者,它会覆盖全局属性。

spring.kafka.producer.buffer-memory

生产者可用于缓冲等待发送到服务器的记录的总内存大小。

spring.kafka.producer.client-id

发出请求时传递给服务器的 ID。用于服务器端日志记录。

spring.kafka.producer.compression-type

生产者生成的所有数据的压缩类型。

spring.kafka.producer.key-serializer

键的序列化器类。

spring.kafka.producer.properties.*

用于配置客户端的额外 producer 特定属性。

spring.kafka.producer.retries

大于零时,启用失败发送的重试。

spring.kafka.producer.security.protocol

与 broker 通信使用的安全协议。

spring.kafka.producer.ssl.bundle

要使用的 SSL 捆绑包名称。

spring.kafka.producer.ssl.key-password

密钥库密钥或密钥库文件中的私钥密码。

spring.kafka.producer.ssl.key-store-certificate-chain

PEM 格式的证书链,包含 X.509 证书列表。

spring.kafka.producer.ssl.key-store-key

PEM 格式的私钥,包含 PKCS#8 密钥。

spring.kafka.producer.ssl.key-store-location

密钥库文件位置。

spring.kafka.producer.ssl.key-store-password

密钥库文件的存储密码。

spring.kafka.producer.ssl.key-store-type

密钥库类型。

spring.kafka.producer.ssl.protocol

要使用的 SSL 协议。

spring.kafka.producer.ssl.trust-store-certificates

PEM 格式的受信任证书,包含 X.509 证书。

spring.kafka.producer.ssl.trust-store-location

信任库文件位置。

spring.kafka.producer.ssl.trust-store-password

信任库文件的存储密码。

spring.kafka.producer.ssl.trust-store-type

信任库类型。

spring.kafka.producer.transaction-id-prefix

非空时,启用生产者的事务支持。

spring.kafka.producer.value-serializer

值的序列化器类。

spring.kafka.properties.*

额外的属性,生产者和消费者通用,用于配置客户端。

spring.kafka.retry.topic.attempts

在将消息发送到 DLT 之前尝试处理的总次数。

3

spring.kafka.retry.topic.backoff.delay

规范的退避周期。在指数情况下用作初始值,在一致性情况下用作最小值。

1s

spring.kafka.retry.topic.backoff.max-delay

重试之间的最大等待时间。如果小于 delay,则应用默认值 30 秒。

0

spring.kafka.retry.topic.backoff.multiplier

用于生成下一次退避延迟的乘数。

0

spring.kafka.retry.topic.backoff.random

是否具有退避延迟。

false

spring.kafka.retry.topic.enabled

是否启用基于主题的非阻塞重试。

false

spring.kafka.security.protocol

与 broker 通信使用的安全协议。

spring.kafka.ssl.bundle

要使用的 SSL 捆绑包名称。

spring.kafka.ssl.key-password

密钥库密钥或密钥库文件中的私钥密码。

spring.kafka.ssl.key-store-certificate-chain

PEM 格式的证书链,包含 X.509 证书列表。

spring.kafka.ssl.key-store-key

PEM 格式的私钥,包含 PKCS#8 密钥。

spring.kafka.ssl.key-store-location

密钥库文件位置。

spring.kafka.ssl.key-store-password

密钥库文件的存储密码。

spring.kafka.ssl.key-store-type

密钥库类型。

spring.kafka.ssl.protocol

要使用的 SSL 协议。

spring.kafka.ssl.trust-store-certificates

PEM 格式的受信任证书,包含 X.509 证书。

spring.kafka.ssl.trust-store-location

信任库文件位置。

spring.kafka.ssl.trust-store-password

信任库文件的存储密码。

spring.kafka.ssl.trust-store-type

信任库类型。

spring.kafka.streams.application-id

Kafka Streams application.id 属性;默认为 spring.application.name。

spring.kafka.streams.auto-startup

是否自动启动 streams factory bean。

true

spring.kafka.streams.bootstrap-servers

用于建立与 Kafka 集群初始连接的主机:端口对列表。对于 streams,这将覆盖全局属性。

spring.kafka.streams.cleanup.on-shutdown

在关闭时清理应用程序的本地状态目录。

false

spring.kafka.streams.cleanup.on-startup

在启动时清理应用程序的本地状态目录。

false

spring.kafka.streams.client-id

发出请求时传递给服务器的 ID。用于服务器端日志记录。

spring.kafka.streams.properties.*

用于配置 streams 的附加 Kafka 属性。

spring.kafka.streams.replication-factor

stream 处理应用程序创建的更改日志主题和重新分区主题的复制因子。

spring.kafka.streams.security.protocol

与 broker 通信使用的安全协议。

spring.kafka.streams.ssl.bundle

要使用的 SSL 捆绑包名称。

spring.kafka.streams.ssl.key-password

密钥库密钥或密钥库文件中的私钥密码。

spring.kafka.streams.ssl.key-store-certificate-chain

PEM 格式的证书链,包含 X.509 证书列表。

spring.kafka.streams.ssl.key-store-key

PEM 格式的私钥,包含 PKCS#8 密钥。

spring.kafka.streams.ssl.key-store-location

密钥库文件位置。

spring.kafka.streams.ssl.key-store-password

密钥库文件的存储密码。

spring.kafka.streams.ssl.key-store-type

密钥库类型。

spring.kafka.streams.ssl.protocol

要使用的 SSL 协议。

spring.kafka.streams.ssl.trust-store-certificates

PEM 格式的受信任证书,包含 X.509 证书。

spring.kafka.streams.ssl.trust-store-location

信任库文件位置。

spring.kafka.streams.ssl.trust-store-password

信任库文件的存储密码。

spring.kafka.streams.ssl.trust-store-type

信任库类型。

spring.kafka.streams.state-dir

状态存储的目录位置。

spring.kafka.streams.state-store-cache-max-size

所有线程中内存状态存储缓存的最大大小。

spring.kafka.template.default-topic

发送消息的默认主题。

spring.kafka.template.observation-enabled

是否启用观测。

false

spring.kafka.template.transaction-id-prefix

事务 ID 前缀,覆盖生产者工厂中的事务 ID 前缀。

spring.pulsar.admin.authentication.param.*

认证参数,表示为参数名称到参数值的映射。

spring.pulsar.admin.authentication.plugin-class-name

认证插件的完全限定类名。

spring.pulsar.admin.connection-timeout

等待建立服务器连接的持续时间。

1m

spring.pulsar.admin.read-timeout

任何请求的服务器响应读取超时。

1m

spring.pulsar.admin.request-timeout

任何请求的服务器请求超时。

5m

spring.pulsar.admin.service-url

Pulsar 管理端点的 Web URL,格式为 '(http|https)://host:port'。

http://localhost:8080

spring.pulsar.client.authentication.param.*

认证参数,表示为参数名称到参数值的映射。

spring.pulsar.client.authentication.plugin-class-name

认证插件的完全限定类名。

spring.pulsar.client.connection-timeout

等待建立与 Broker 连接的持续时间。

10s

spring.pulsar.client.failover.backup-clusters

备份集群列表。备份集群按给定列表的顺序选择。如果所有备份集群都可用,Pulsar 客户端将选择第一个备份集群。

spring.pulsar.client.failover.check-interval

执行探测任务的频率。

spring.pulsar.client.failover.delay

Pulsar 客户端从主集群切换到备份集群之前的延迟。

spring.pulsar.client.failover.policy

集群故障转移策略。

order

spring.pulsar.client.failover.switch-back-delay

Pulsar 客户端从备份集群切换到主集群之前的延迟。

spring.pulsar.client.lookup-timeout

客户端查找超时。

spring.pulsar.client.operation-timeout

客户端操作超时。

30s

spring.pulsar.client.service-url

Pulsar 服务 URL,格式为 '(pulsar|pulsar+ssl)://host:port'。

pulsar://localhost:6650

spring.pulsar.client.threads.io

用于处理与 Broker 连接的线程数。

spring.pulsar.client.threads.listener

用于消息监听器的线程数。

spring.pulsar.consumer.dead-letter-policy.dead-letter-topic

发送失败消息的死信主题名称。

spring.pulsar.consumer.dead-letter-policy.initial-subscription-name

死信主题的初始订阅名称。未设置时,不会创建初始订阅。但是,设置此属性后,必须启用 Broker 的“allowAutoSubscriptionCreation”,否则 DLQ 生产者将失败。

spring.pulsar.consumer.dead-letter-policy.max-redeliver-count

在消息被发送到死信队列之前将被重新投递的最大次数。

0

spring.pulsar.consumer.dead-letter-policy.retry-letter-topic

发送失败消息的重试主题名称。

spring.pulsar.consumer.name

消费者名称,用于从主题统计信息中识别特定消费者。

spring.pulsar.consumer.priority-level

共享订阅消费者的优先级级别。

0

spring.pulsar.consumer.read-compacted

是否从压缩主题读取消息,而不是完整的消息积压。

false

spring.pulsar.consumer.retry-enable

是否自动重试消息。

false

spring.pulsar.consumer.subscription.initial-position

初始化新创建订阅的位置。

latest

spring.pulsar.consumer.subscription.mode

订阅主题时使用的订阅模式。

durable

spring.pulsar.consumer.subscription.name

消费者的订阅名称。

spring.pulsar.consumer.subscription.topics-mode

确定在使用模式订阅时,消费者应订阅哪种类型的主题(持久、非持久或全部)。

persistentonly

spring.pulsar.consumer.subscription.type

订阅主题时使用的订阅类型。

exclusive

spring.pulsar.consumer.topics

消费者订阅的主题。

spring.pulsar.consumer.topics-pattern

消费者订阅的主题模式。

spring.pulsar.defaults.topic.enabled

是否为主题启用默认租户和命名空间支持。

true

spring.pulsar.defaults.topic.namespace

对非完全限定主题 URL 生产或消费消息时使用的默认命名空间。

default

spring.pulsar.defaults.topic.tenant

对非完全限定主题 URL 生产或消费消息时使用的默认租户。

public

spring.pulsar.defaults.type-mappings

消息类型到主题名称和 schema 信息的映射列表,当生产或消费映射类型的消息时,如果未明确指定主题名称和/或 schema,则使用这些默认值。

spring.pulsar.function.enabled

是否启用函数支持。

true

spring.pulsar.function.fail-fast

发生故障时是否停止处理后续的函数创建/更新。

true

spring.pulsar.function.propagate-failures

在服务器启动期间创建/更新函数时,如果遇到任何故障,是否抛出异常。

true

spring.pulsar.function.propagate-stop-failures

在服务器关闭期间对函数强制执行停止策略时,如果遇到任何故障,是否抛出异常。

false

spring.pulsar.listener.concurrency

监听器容器使用的线程数。

spring.pulsar.listener.observation-enabled

在 Observations API 可用且客户端支持时,是否记录观测数据。

false

spring.pulsar.listener.schema-type

消费消息的 SchemaType。

spring.pulsar.producer.access-mode

生产者访问主题所需的访问类型。

shared

spring.pulsar.producer.batching-enabled

是否自动批量处理消息。

true

spring.pulsar.producer.cache.enabled

是否在 PulsarProducerFactory 中启用缓存。

true

spring.pulsar.producer.cache.expire-after-access

缓存中未使用条目的过期时间段。

1m

spring.pulsar.producer.cache.initial-capacity

缓存的初始大小。

50

spring.pulsar.producer.cache.maximum-size

缓存的最大大小(条目数)。

1000

spring.pulsar.producer.chunking-enabled

是否将大尺寸消息分割成多个块。

false

spring.pulsar.producer.compression-type

消息压缩类型。

spring.pulsar.producer.hashing-scheme

选择消息发布到哪个分区的消息哈希方案。

javastringhash

spring.pulsar.producer.message-routing-mode

分区生产者的消息路由模式。

roundrobinpartition

spring.pulsar.producer.name

生产者的名称。如果未指定,将生成一个唯一名称。

spring.pulsar.producer.send-timeout

消息必须由 Broker 确认的时间。

30s

spring.pulsar.producer.topic-name

生产者将发布到的主题。

spring.pulsar.reader.name

读取器名称。

spring.pulsar.reader.read-compacted

是否从压缩主题读取消息,而不是主题的完整消息积压。

false

spring.pulsar.reader.subscription-name

订阅名称。

spring.pulsar.reader.subscription-role-prefix

订阅角色的前缀。

spring.pulsar.reader.topics

读取器订阅的主题。

spring.pulsar.template.observations-enabled

在 Observations API 可用时,是否记录观测数据。

false

spring.pulsar.transaction.enabled

是否启用事务支持。

false

spring.rabbitmq.address-shuffle-mode

用于打乱配置地址的模式。

spring.rabbitmq.addresses

客户端应连接的地址列表。设置后,host 和 port 将被忽略。

spring.rabbitmq.cache.channel.checkout-timeout

如果缓存大小已达到限制,等待获取通道的持续时间。如果为 0,则始终创建一个新通道。

spring.rabbitmq.cache.channel.size

缓存中保留的通道数。当 "check-timeout" > 0 时,表示每个连接的最大通道数。

spring.rabbitmq.cache.connection.mode

连接工厂缓存模式。

channel

spring.rabbitmq.cache.connection.size

缓存的连接数。仅在模式为 CONNECTION 时适用。

spring.rabbitmq.channel-rpc-timeout

通道中 RPC 调用的延续超时。设置为零表示永远等待。

10m

spring.rabbitmq.connection-timeout

连接超时。设置为零表示永远等待。

spring.rabbitmq.dynamic

是否创建 AmqpAdmin bean。

true

spring.rabbitmq.host

RabbitMQ 主机。如果设置了地址,则忽略此项。

localhost

spring.rabbitmq.listener.direct.acknowledge-mode

容器的确认模式。

spring.rabbitmq.listener.direct.auto-startup

是否在启动时自动启动容器。

true

spring.rabbitmq.listener.direct.consumers-per-queue

每个队列的消费者数量。

spring.rabbitmq.listener.direct.de-batching-enabled

容器是将批量消息作为离散消息呈现,还是使用批量调用监听器。

true

spring.rabbitmq.listener.direct.default-requeue-rejected

默认情况下是否重新入队被拒绝的投递。

spring.rabbitmq.listener.direct.force-stop

容器(停止时)是应在处理当前消息后立即停止,还是在处理完所有预取消息后停止。

false

spring.rabbitmq.listener.direct.idle-event-interval

发布空闲容器事件的频率。

spring.rabbitmq.listener.direct.missing-queues-fatal

如果容器声明的队列在 Broker 上不可用时是否失败。

false

spring.rabbitmq.listener.direct.observation-enabled

是否启用观测。

false

spring.rabbitmq.listener.direct.prefetch

每个消费者未确认消息的最大数量。

spring.rabbitmq.listener.direct.retry.enabled

是否启用发布重试。

false

spring.rabbitmq.listener.direct.retry.initial-interval

第一次和第二次尝试投递消息之间的持续时间。

1000ms

spring.rabbitmq.listener.direct.retry.max-attempts

尝试投递消息的最大次数。

3

spring.rabbitmq.listener.direct.retry.max-interval

尝试之间的最大持续时间。

10000ms

spring.rabbitmq.listener.direct.retry.multiplier

应用于上一个重试间隔的乘数。

1

spring.rabbitmq.listener.direct.retry.stateless

重试是无状态的还是有状态的。

true

spring.rabbitmq.listener.simple.acknowledge-mode

容器的确认模式。

spring.rabbitmq.listener.simple.auto-startup

是否在启动时自动启动容器。

true

spring.rabbitmq.listener.simple.batch-size

批处理大小,表示容器将使用的物理消息数量。

spring.rabbitmq.listener.simple.concurrency

监听器调用线程的最小数量。

spring.rabbitmq.listener.simple.consumer-batch-enabled

容器是否根据“receive-timeout”和“batch-size”创建一批消息。强制将“de-batching-enabled”设置为 true,以将生产者创建的批量内容作为离散记录包含在批处理中。

false

spring.rabbitmq.listener.simple.de-batching-enabled

容器是将批量消息作为离散消息呈现,还是使用批量调用监听器。

true

spring.rabbitmq.listener.simple.default-requeue-rejected

默认情况下是否重新入队被拒绝的投递。

spring.rabbitmq.listener.simple.force-stop

容器(停止时)是应在处理当前消息后立即停止,还是在处理完所有预取消息后停止。

false

spring.rabbitmq.listener.simple.idle-event-interval

发布空闲容器事件的频率。

spring.rabbitmq.listener.simple.max-concurrency

监听器调用线程的最大数量。

spring.rabbitmq.listener.simple.missing-queues-fatal

如果容器声明的队列在 Broker 上不可用时是否失败,以及/或者如果在运行时删除一个或多个队列时是否停止容器。

true

spring.rabbitmq.listener.simple.observation-enabled

是否启用观测。

false

spring.rabbitmq.listener.simple.prefetch

每个消费者未确认消息的最大数量。

spring.rabbitmq.listener.simple.retry.enabled

是否启用发布重试。

false

spring.rabbitmq.listener.simple.retry.initial-interval

第一次和第二次尝试投递消息之间的持续时间。

1000ms

spring.rabbitmq.listener.simple.retry.max-attempts

尝试投递消息的最大次数。

3

spring.rabbitmq.listener.simple.retry.max-interval

尝试之间的最大持续时间。

10000ms

spring.rabbitmq.listener.simple.retry.multiplier

应用于上一个重试间隔的乘数。

1

spring.rabbitmq.listener.simple.retry.stateless

重试是无状态的还是有状态的。

true

spring.rabbitmq.listener.stream.native-listener

容器是否支持消费原生流消息而非 Spring AMQP 消息的监听器。

false

spring.rabbitmq.listener.stream.observation-enabled

是否启用观测。

false

spring.rabbitmq.listener.type

监听器容器类型。

simple

spring.rabbitmq.max-inbound-message-body-size

入站(接收)消息正文的最大大小。

64MB

spring.rabbitmq.password

用于向 Broker 进行身份验证的登录名。

guest

spring.rabbitmq.port

RabbitMQ 端口。如果设置了地址,则忽略此项。默认为 5672,如果启用 SSL 则为 5671。

spring.rabbitmq.publisher-confirm-type

要使用的发布者确认类型。

spring.rabbitmq.publisher-returns

是否启用发布者返回。

false

spring.rabbitmq.requested-channel-max

客户端请求的每个连接的通道数。使用 0 表示无限制。

2047

spring.rabbitmq.requested-heartbeat

请求的心跳超时;零表示无心跳。如果未指定持续时间后缀,将使用秒作为单位。

spring.rabbitmq.ssl.algorithm

要使用的 SSL 算法。默认情况下,由 Rabbit 客户端库配置。

spring.rabbitmq.ssl.bundle

SSL bundle 名称。

spring.rabbitmq.ssl.enabled

是否启用 SSL 支持。如果提供了包含协议的地址 (amqp:// vs. amqps://),则自动确定。

spring.rabbitmq.ssl.key-store

存放 SSL 证书的密钥库路径。

spring.rabbitmq.ssl.key-store-algorithm

密钥库算法。

SunX509

spring.rabbitmq.ssl.key-store-password

用于访问密钥库的密码。

spring.rabbitmq.ssl.key-store-type

密钥库类型。

PKCS12

spring.rabbitmq.ssl.trust-store

包含 SSL 证书的信任库。

spring.rabbitmq.ssl.trust-store-algorithm

信任库算法。

SunX509

spring.rabbitmq.ssl.trust-store-password

用于访问信任库的密码。

spring.rabbitmq.ssl.trust-store-type

信任库类型。

JKS

spring.rabbitmq.ssl.validate-server-certificate

是否启用服务器端证书验证。

true

spring.rabbitmq.ssl.verify-hostname

是否启用主机名验证。

true

spring.rabbitmq.stream.host

启用了 Stream 插件的 RabbitMQ 实例的主机。

localhost

spring.rabbitmq.stream.name

流的名称。

spring.rabbitmq.stream.password

用于向 Broker 进行身份验证的登录密码。未设置时,使用 spring.rabbitmq.password。

spring.rabbitmq.stream.port

启用了 Stream 插件的 RabbitMQ 实例的 Stream 端口。

spring.rabbitmq.stream.username

用于向 Broker 进行身份验证的登录用户。未设置时,使用 spring.rabbitmq.username。

spring.rabbitmq.stream.virtual-host

启用了 Stream 插件的 RabbitMQ 实例的虚拟主机。未设置时,使用 spring.rabbitmq.virtual-host。

spring.rabbitmq.template.allowed-list-patterns

用于反序列化的允许包/类的简单模式。

spring.rabbitmq.template.default-receive-queue

未明确指定时,接收消息的默认队列名称。

spring.rabbitmq.template.exchange

发送操作使用的默认交换机名称。

spring.rabbitmq.template.mandatory

是否启用强制消息。

spring.rabbitmq.template.observation-enabled

是否启用观测。

false

spring.rabbitmq.template.receive-timeout

receive() 操作的超时时间。

spring.rabbitmq.template.reply-timeout

sendAndReceive() 操作的超时时间。

spring.rabbitmq.template.retry.enabled

是否启用发布重试。

false

spring.rabbitmq.template.retry.initial-interval

第一次和第二次尝试投递消息之间的持续时间。

1000ms

spring.rabbitmq.template.retry.max-attempts

尝试投递消息的最大次数。

3

spring.rabbitmq.template.retry.max-interval

尝试之间的最大持续时间。

10000ms

spring.rabbitmq.template.retry.multiplier

应用于上一个重试间隔的乘数。

1

spring.rabbitmq.template.routing-key

用于发送操作的默认路由键的值。

spring.rabbitmq.username

用于向代理认证的登录用户。

guest

spring.rabbitmq.virtual-host

连接到代理时使用的虚拟主机。

spring.webservices.path

用作服务基本 URI 的路径。

/services

spring.webservices.servlet.init.*

要传递给 Spring Web Services 的 Servlet 初始化参数。

spring.webservices.servlet.load-on-startup

Spring Web Services Servlet 的启动时加载优先级。

-1

spring.webservices.wsdl-locations

以逗号分隔的 WSDL 及其附属 XSD 的位置列表,这些位置将被暴露为 beans。

JSON 属性

名称 描述 默认值

spring.gson.date-format

序列化 Date 对象时使用的格式。

spring.gson.disable-html-escaping

是否禁用对 HTML 字符(如 '<', '>' 等)的转义。

spring.gson.disable-inner-class-serialization

序列化期间是否排除内部类。

spring.gson.enable-complex-map-key-serialization

是否启用复杂映射键(即非原始类型)的序列化。

spring.gson.exclude-fields-without-expose-annotation

是否排除所有没有 "Expose" 注解的字段进行序列化或反序列化。

spring.gson.field-naming-policy

在序列化和反序列化期间应应用于对象字段的命名策略。

spring.gson.generate-non-executable-json

是否通过在输出前面添加一些特殊文本来生成不可执行的 JSON。

spring.gson.long-serialization-policy

Long 和 long 类型的序列化策略。

spring.gson.pretty-printing

是否输出适合一页用于美观打印的序列化 JSON。

spring.gson.serialize-nulls

是否序列化 null 字段。

spring.gson.strictness

设置在读写 JSON 时,RFC 8259 规范将执行的严格程度。

spring.jackson.constructor-detector

用于自动检测构造函数的策略,特别是单参数构造函数的行为。

default

spring.jackson.datatype.enum.*

Jackson 枚举类型的开关特性。

spring.jackson.datatype.json-node.*

Jackson JsonNodes 的开关特性。

spring.jackson.date-format

日期格式字符串或完全限定的日期格式类名。例如 'yyyy-MM-dd HH:mm:ss'。

spring.jackson.default-leniency

全局默认设置(如果有)用于宽松处理。

spring.jackson.default-property-inclusion

控制序列化期间属性的包含。使用 Jackson 的 JsonInclude.Include 枚举中的一个值进行配置。

spring.jackson.deserialization.*

影响 Java 对象反序列化方式的 Jackson 开关特性。

spring.jackson.generator.*

Jackson 生成器的开关特性。

spring.jackson.locale

用于格式化的语言环境。

spring.jackson.mapper.*

Jackson 通用开关特性。

spring.jackson.parser.*

Jackson 解析器的开关特性。

spring.jackson.property-naming-strategy

Jackson PropertyNamingStrategies 中的一个常量。也可以是 PropertyNamingStrategy 实现类的完全限定类名。

spring.jackson.serialization.*

影响 Java 对象序列化方式的 Jackson 开关特性。

spring.jackson.time-zone

格式化日期时使用的时区。例如 "America/Los_Angeles" 或 "GMT+10"。

spring.jackson.visibility.*

Jackson 可见性阈值,可用于限制哪些方法(和字段)被自动检测。

邮件属性

名称 描述 默认值

spring.mail.default-encoding

默认的 MimeMessage 编码。

UTF-8

spring.mail.host

SMTP 服务器主机。例如 'smtp.example.com'。

spring.mail.jndi-name

Session 的 JNDI 名称。设置后,优先于其他 Session 设置。

spring.mail.password

SMTP 服务器的登录密码。

spring.mail.port

SMTP 服务器端口。

spring.mail.properties.*

附加的 JavaMail Session 属性。

spring.mail.protocol

SMTP 服务器使用的协议。

smtp

spring.mail.ssl.bundle

SSL bundle 名称。如果设置,'mail.(protocol).ssl.socketFactory' 属性将设置为从相应 SSL bundle 获取的 SSLSocketFactory。<p> 请注意,STARTTLS 命令可以使用相应的 SSLSocketFactory,即使 'mail.(protocol).ssl.enable' 属性未设置。

spring.mail.ssl.enabled

是否启用 SSL 支持。如果启用,'mail.(protocol).ssl.enable' 属性将设置为 'true'。

false

spring.mail.test-connection

启动时是否测试邮件服务器可用。

false

spring.mail.username

SMTP 服务器的登录用户。

spring.sendgrid.api-key

SendGrid API 密钥。

spring.sendgrid.proxy.host

SendGrid 代理主机。

spring.sendgrid.proxy.port

SendGrid 代理端口。

RSocket 属性

名称 描述 默认值

spring.rsocket.server.address

服务器应绑定的网络地址。

spring.rsocket.server.fragment-size

最大传输单元。大于指定值的帧将被分段。

spring.rsocket.server.mapping-path

RSocket 处理请求的路径(仅适用于 websocket 传输)。

spring.rsocket.server.port

服务器端口。

spring.rsocket.server.spec.compress

是否启用 websocket 压缩扩展。

false

spring.rsocket.server.spec.handle-ping

是代理 websocket ping 帧还是响应它们。

false

spring.rsocket.server.spec.max-frame-payload-length

允许的最大帧有效载荷长度。

65536B

spring.rsocket.server.spec.protocols

在 websocket 握手签名中使用的子协议。

spring.rsocket.server.ssl.bundle

配置的 SSL 包名称。

spring.rsocket.server.ssl.certificate

PEM 编码的 SSL 证书文件路径。

spring.rsocket.server.ssl.certificate-private-key

SSL 证书的 PEM 编码私钥文件路径。

spring.rsocket.server.ssl.ciphers

支持的 SSL 密码套件。

spring.rsocket.server.ssl.client-auth

客户端认证模式。需要信任库。

spring.rsocket.server.ssl.enabled

是否启用 SSL 支持。

true

spring.rsocket.server.ssl.enabled-protocols

启用的 SSL 协议。

spring.rsocket.server.ssl.key-alias

标识密钥库中密钥的别名。

spring.rsocket.server.ssl.key-password

用于访问密钥库中密钥的密码。

spring.rsocket.server.ssl.key-store

包含 SSL 证书的密钥库路径(通常是 jks 文件)。

spring.rsocket.server.ssl.key-store-password

用于访问密钥库的密码。

spring.rsocket.server.ssl.key-store-provider

密钥库的提供者。

spring.rsocket.server.ssl.key-store-type

密钥库类型。

spring.rsocket.server.ssl.protocol

要使用的 SSL 协议。

TLS

spring.rsocket.server.ssl.server-name-bundles

用于 SNI 配置的主机名到 SSL 包的映射。

spring.rsocket.server.ssl.trust-certificate

PEM 编码的 SSL 证书颁发机构文件路径。

spring.rsocket.server.ssl.trust-certificate-private-key

SSL 证书颁发机构的 PEM 编码私钥文件路径。

spring.rsocket.server.ssl.trust-store

包含 SSL 证书的信任库。

spring.rsocket.server.ssl.trust-store-password

用于访问信任库的密码。

spring.rsocket.server.ssl.trust-store-provider

信任库的提供者。

spring.rsocket.server.ssl.trust-store-type

信任库类型。

spring.rsocket.server.transport

RSocket 传输协议。

tcp

安全属性

名称 描述 默认值

spring.security.filter.dispatcher-types

基于 Servlet 的 Web 应用程序的安全过滤器链分发器类型。

[async, error, forward, include, request]

spring.security.filter.order

基于 Servlet 的 Web 应用程序的安全过滤器链顺序。

-100

spring.security.oauth2.authorizationserver.client.*

授权服务器的注册客户端。

spring.security.oauth2.authorizationserver.endpoint.authorization-uri

授权服务器的 OAuth 2.0 授权端点。

/oauth2/authorize

spring.security.oauth2.authorizationserver.endpoint.device-authorization-uri

授权服务器的 OAuth 2.0 设备授权端点。

/oauth2/device_authorization

spring.security.oauth2.authorizationserver.endpoint.device-verification-uri

授权服务器的 OAuth 2.0 设备验证端点。

/oauth2/device_verification

spring.security.oauth2.authorizationserver.endpoint.jwk-set-uri

授权服务器的 JWK Set 端点。

/oauth2/jwks

spring.security.oauth2.authorizationserver.endpoint.oidc.client-registration-uri

授权服务器的 OpenID Connect 1.0 客户端注册端点。

/connect/register

spring.security.oauth2.authorizationserver.endpoint.oidc.logout-uri

授权服务器的 OpenID Connect 1.0 注销端点。

/connect/logout

spring.security.oauth2.authorizationserver.endpoint.oidc.user-info-uri

授权服务器的 OpenID Connect 1.0 UserInfo 端点。

/userinfo

spring.security.oauth2.authorizationserver.endpoint.token-introspection-uri

授权服务器的 OAuth 2.0 Token 内省端点。

/oauth2/introspect

spring.security.oauth2.authorizationserver.endpoint.token-revocation-uri

授权服务器的 OAuth 2.0 Token 撤销端点。

/oauth2/revoke

spring.security.oauth2.authorizationserver.endpoint.token-uri

授权服务器的 OAuth 2.0 Token 端点。

/oauth2/token

spring.security.oauth2.authorizationserver.issuer

授权服务器的 Issuer Identifier 的 URL。

spring.security.oauth2.authorizationserver.multiple-issuers-allowed

是否允许每个主机有多个颁发者。在颁发者标识符的 URL 中使用路径组件可以在多租户托管配置中支持每个主机上的多个颁发者。

false

spring.security.oauth2.client.provider.*

OAuth 提供程序详细信息。

spring.security.oauth2.client.registration.*

OAuth 客户端注册。

spring.security.oauth2.resourceserver.jwt.audiences

标识 JWT 意图发送到的接收者。

spring.security.oauth2.resourceserver.jwt.authorities-claim-delimiter

用于将 authorities claim 的值拆分为 authorities 的正则表达式。

spring.security.oauth2.resourceserver.jwt.authorities-claim-name

用于从 JWT 映射 authorities 的 token claim 名称。

spring.security.oauth2.resourceserver.jwt.authority-prefix

用于从 JWT 映射的 authorities 的前缀。

spring.security.oauth2.resourceserver.jwt.issuer-uri

可以是 OpenID Connect 发现端点或由 RFC 8414 定义的 OAuth 2.0 Authorization Server Metadata 端点的 URI。

spring.security.oauth2.resourceserver.jwt.jwk-set-uri

用于验证 JWT token 的 JSON Web Key URI。

spring.security.oauth2.resourceserver.jwt.jws-algorithms

用于验证数字签名的 JSON Web Algorithms。

RS256

spring.security.oauth2.resourceserver.jwt.principal-claim-name

JWT principal claim 名称。

spring.security.oauth2.resourceserver.jwt.public-key-location

包含用于验证 JWT 的公钥的文件位置。

spring.security.oauth2.resourceserver.opaquetoken.client-id

用于向 token 内省端点进行认证的客户端 id。

spring.security.oauth2.resourceserver.opaquetoken.client-secret

用于向 token 内省端点进行认证的客户端 secret。

spring.security.oauth2.resourceserver.opaquetoken.introspection-uri

完成 token 内省的 OAuth 2.0 端点。

spring.security.saml2.relyingparty.registration.*

SAML2 依赖方注册。

spring.security.user.name

默认用户名。

user

spring.security.user.password

默认用户名的密码。

spring.security.user.roles

默认用户名的授权角色。

服务器属性

名称 描述 默认值

server.address

服务器应绑定的网络地址。

server.compression.enabled

是否启用响应压缩。

false

server.compression.excluded-user-agents

以逗号分隔的用户代理列表,对这些用户代理的响应不应压缩。

server.compression.mime-types

以逗号分隔的应压缩的 MIME 类型列表。

[text/html, text/xml, text/plain, text/css, text/javascript, application/javascript, application/json, application/xml]

server.compression.min-response-size

执行压缩所需的最小 "Content-Length" 值。

2KB

server.error.include-binding-errors

何时包含 "errors" 属性。

never

server.error.include-exception

包含 "exception" 属性。

false

server.error.include-message

何时包含 "message" 属性。

never

server.error.include-path

何时包含 "path" 属性。

always

server.error.include-stacktrace

何时包含 "trace" 属性。

never

server.error.path

错误控制器的路径。

/error

server.error.whitelabel.enabled

服务器错误时是否启用在浏览器中显示的默认错误页面。

true

server.forward-headers-strategy

处理 X-Forwarded-* 头部的策略。

server.http2.enabled

如果当前环境支持,是否启用 HTTP/2 支持。

false

server.jetty.accesslog.append

追加到日志。

false

server.jetty.accesslog.custom-format

自定义日志格式,参见 org.eclipse.jetty.server.CustomRequestLog。如果已定义,将覆盖 "format" 配置键。

server.jetty.accesslog.enabled

启用访问日志。

false

server.jetty.accesslog.file-date-format

放置在日志文件名中的日期格式。

server.jetty.accesslog.filename

日志文件名。如果未指定,日志将重定向到 "System.err"。

server.jetty.accesslog.format

日志格式。

ncsa

server.jetty.accesslog.ignore-paths

不应记录的请求路径。

server.jetty.accesslog.retention-period

轮转日志文件被删除前的天数。

31

server.jetty.connection-idle-timeout

连接在关闭前可以保持空闲的时间。

server.jetty.max-connections

服务器在任何给定时间接受和处理的最大连接数。

-1

server.jetty.max-form-keys

表单键的最大数量。

1000

server.jetty.max-http-form-post-size

任何 HTTP POST 请求中表单内容的最大大小。

200000B

server.jetty.max-http-response-header-size

HTTP 响应头的最大大小。

8KB

server.jetty.threads.acceptors

使用的 acceptor 线程数。当值为 -1(默认值)时,acceptor 数量从操作系统环境中获取。

-1

server.jetty.threads.idle-timeout

最大线程空闲时间。

60000ms

server.jetty.threads.max

最大线程数。如果启用了虚拟线程,则此设置无效。

200

server.jetty.threads.max-queue-capacity

线程池后端队列的最大容量。默认值根据线程配置计算。

server.jetty.threads.min

最小线程数。如果启用了虚拟线程,则此设置无效。

8

server.jetty.threads.selectors

使用的 selector 线程数。当值为 -1(默认值)时,selector 数量从操作系统环境中获取。

-1

server.max-http-request-header-size

HTTP 请求头的最大大小。有关此限制具体如何应用的详细信息,请参阅所选嵌入式服务器的文档。例如,Netty 将此限制分别应用于请求中的每个单独头部,而 Tomcat 将此限制应用于请求行以及请求中所有头部名称和值的组合大小。

8KB

server.netty.connection-timeout

Netty 通道的连接超时时间。

server.netty.h2c-max-content-length

H2C 升级请求的最大内容长度。

0B

server.netty.idle-timeout

Netty 通道的空闲超时时间。如果未指定,则使用无限超时。

server.netty.initial-buffer-size

用于 HTTP 请求解码的初始缓冲区大小。

128B

server.netty.max-initial-line-length

可解码的 HTTP 请求初始行的最大长度。

4KB

server.netty.max-keep-alive-requests

每个连接可发出的最大请求数。默认情况下,一个连接服务无限数量的请求。

server.netty.validate-headers

解码请求时是否验证头部。

true

server.port

服务器 HTTP 端口。

8080

server.reactive.session.cookie.domain

Cookie 的域。

server.reactive.session.cookie.http-only

是否为 Cookie 使用 "HttpOnly" Cookie。

server.reactive.session.cookie.max-age

Cookie 的最大年龄。如果未指定持续时间后缀,则使用秒。正值表示 Cookie 相对于当前时间的过期时间。值为 0 表示 Cookie 应立即过期。负值表示没有 "Max-Age"。

server.reactive.session.cookie.name

Cookie 的名称。

server.reactive.session.cookie.partitioned

生成的 Cookie 是否带有 Partitioned 属性。

server.reactive.session.cookie.path

Cookie 的路径。

server.reactive.session.cookie.same-site

Cookie 的 SameSite 设置。

server.reactive.session.cookie.secure

是否始终将 Cookie 标记为 secure。

server.reactive.session.max-sessions

可存储的最大会话数。

10000

server.reactive.session.timeout

会话超时时间。如果未指定持续时间后缀,将使用秒作为单位。

30m

server.server-header

用于 Server 响应头的值(如果为空,则不发送此头)。

server.servlet.application-display-name

应用程序的显示名称。

application

server.servlet.context-parameters.*

Servlet context 初始化参数。

server.servlet.context-path

应用程序的 context path。

server.servlet.encoding.charset

HTTP 请求和响应的字符集。如果未显式设置,将添加到 "Content-Type" 头。

UTF-8

server.servlet.encoding.enabled

是否启用 http 编码支持。

true

server.servlet.encoding.force

是否强制 HTTP 请求和响应使用配置的字符集进行编码。

server.servlet.encoding.force-request

是否强制 HTTP 请求使用配置的字符集进行编码。如果未指定 "force",则默认为 true。

server.servlet.encoding.force-response

是否强制 HTTP 响应使用配置的字符集进行编码。

server.servlet.encoding.mapping.*

用于响应编码的 locale 到字符集的映射。

server.servlet.jsp.class-name

用于 JSP 的 servlet 类名。如果 registered 为 true 且该类在 classpath 中,则会注册此 servlet。

org.apache.jasper.servlet.JspServlet

server.servlet.jsp.init-parameters.*

用于配置 JSP servlet 的初始化参数。

server.servlet.jsp.registered

是否注册 JSP servlet。

true

server.servlet.register-default-servlet

是否向容器注册默认 Servlet。

false

server.servlet.session.cookie.domain

Cookie 的域。

server.servlet.session.cookie.http-only

是否为 Cookie 使用 "HttpOnly" Cookie。

server.servlet.session.cookie.max-age

Cookie 的最大年龄。如果未指定持续时间后缀,则使用秒。正值表示 Cookie 相对于当前时间的过期时间。值为 0 表示 Cookie 应立即过期。负值表示没有 "Max-Age"。

server.servlet.session.cookie.name

Cookie 的名称。

server.servlet.session.cookie.partitioned

生成的 Cookie 是否带有 Partitioned 属性。

server.servlet.session.cookie.path

Cookie 的路径。

server.servlet.session.cookie.same-site

Cookie 的 SameSite 设置。

server.servlet.session.cookie.secure

是否始终将 Cookie 标记为 secure。

server.servlet.session.persistent

是否在重启之间持久化会话数据。

false

server.servlet.session.store-dir

用于存储会话数据的目录。

server.servlet.session.timeout

会话超时时间。如果未指定持续时间后缀,将使用秒作为单位。

30m

server.servlet.session.tracking-modes

会话跟踪模式。

server.shutdown

服务器将支持的关闭类型。

graceful

server.ssl.bundle

配置的 SSL 包名称。

server.ssl.certificate

PEM 编码的 SSL 证书文件路径。

server.ssl.certificate-private-key

SSL 证书的 PEM 编码私钥文件路径。

server.ssl.ciphers

支持的 SSL 密码套件。

server.ssl.client-auth

客户端认证模式。需要信任库。

server.ssl.enabled

是否启用 SSL 支持。

true

server.ssl.enabled-protocols

启用的 SSL 协议。

server.ssl.key-alias

标识密钥库中密钥的别名。

server.ssl.key-password

用于访问密钥库中密钥的密码。

server.ssl.key-store

包含 SSL 证书的密钥库路径(通常是 jks 文件)。

server.ssl.key-store-password

用于访问密钥库的密码。

server.ssl.key-store-provider

密钥库的提供者。

server.ssl.key-store-type

密钥库类型。

server.ssl.protocol

要使用的 SSL 协议。

TLS

server.ssl.server-name-bundles

用于 SNI 配置的主机名到 SSL 包的映射。

server.ssl.trust-certificate

PEM 编码的 SSL 证书颁发机构文件路径。

server.ssl.trust-certificate-private-key

SSL 证书颁发机构的 PEM 编码私钥文件路径。

server.ssl.trust-store

包含 SSL 证书的信任库。

server.ssl.trust-store-password

用于访问信任库的密码。

server.ssl.trust-store-provider

信任库的提供者。

server.ssl.trust-store-type

信任库类型。

server.tomcat.accept-count

所有可能的请求处理线程都在使用时,传入连接请求的最大队列长度。

100

server.tomcat.accesslog.buffered

是否缓冲输出,使其仅周期性刷新。

true

server.tomcat.accesslog.check-exists

是否检查日志文件是否存在,以便在外部进程重命名它时可以重新创建。

false

server.tomcat.accesslog.condition-if

仅当 "ServletRequest.getAttribute(conditionIf)" 不返回 null 时,才启用请求日志记录。

server.tomcat.accesslog.condition-unless

仅当 "ServletRequest.getAttribute(conditionUnless)" 返回 null 时,才启用请求日志记录。

server.tomcat.accesslog.directory

创建日志文件的目录。可以是绝对路径,也可以是相对于 Tomcat 基本目录的相对路径。

logs

server.tomcat.accesslog.enabled

启用访问日志。

false

server.tomcat.accesslog.encoding

日志文件使用的字符集。默认为系统的默认字符集。

server.tomcat.accesslog.file-date-format

放置在日志文件名中的日期格式。

.yyyy-MM-dd

server.tomcat.accesslog.ipv6-canonical

是否使用 RFC 5952 定义的 IPv6 规范表示格式。

false

server.tomcat.accesslog.locale

用于格式化日志条目中的时间戳和日志文件名后缀的 Locale。默认为 Java 进程的默认 locale。

server.tomcat.accesslog.max-days

访问日志文件在被删除之前保留的天数。

-1

server.tomcat.accesslog.pattern

访问日志的格式模式。

common

server.tomcat.accesslog.prefix

日志文件名前缀。

access_log

server.tomcat.accesslog.rename-on-rotate

是否将日期戳添加到日志文件名的操作延迟到轮换时进行。

false

server.tomcat.accesslog.request-attributes-enabled

为请求设置 IP 地址、主机名、协议和端口的请求属性。

false

server.tomcat.accesslog.rotate

是否启用访问日志轮换。

true

server.tomcat.accesslog.suffix

日志文件名后缀。

.log

server.tomcat.additional-tld-skip-patterns

匹配要忽略的 jars 的额外模式列表,用于 TLD 扫描。特殊字符 '?' 和 '*' 可用于模式中,分别匹配一个且仅一个字符,以及零个或多个字符。

server.tomcat.background-processor-delay

调用 backgroundProcess 方法之间的延迟。如果未指定持续时间后缀,将使用秒作为单位。

10s

server.tomcat.basedir

Tomcat 基本目录。如果未指定,将使用临时目录。

server.tomcat.connection-timeout

连接器在接受连接后等待请求 URI 行出现的时间量。

server.tomcat.keep-alive-timeout

在连接关闭之前等待另一个 HTTP 请求的时间。如果未设置,则使用 connectionTimeout。如果设置为 -1,则没有超时。

server.tomcat.max-connections

服务器在任何给定时间接受和处理的最大连接数。一旦达到限制,操作系统仍可能根据 "acceptCount" 属性接受连接。

8192

server.tomcat.max-http-form-post-size

任何 HTTP POST 请求中表单内容的最大大小。

2MB

server.tomcat.max-http-response-header-size

HTTP 响应头的最大大小。

8KB

server.tomcat.max-keep-alive-requests

在连接关闭之前可以进行管道传输的最大 HTTP 请求数。设置为 0 或 1 时,禁用 keep-alive 和 pipelining。设置为 -1 时,允许无限数量的管道传输或 keep-alive 请求。

100

server.tomcat.max-swallow-size

可吞噬的最大请求体大小。

2MB

server.tomcat.mbeanregistry.enabled

是否应启用 Tomcat 的 MBean Registry。

false

server.tomcat.processor-cache

缓存中保留并可用于后续请求的最大空闲处理器数。设置为 -1 时,缓存大小不受限制,理论最大大小等于最大连接数。

200

server.tomcat.redirect-context-root

对 context root 的请求是否应通过在路径末尾添加 / 进行重定向。当在代理处终止 SSL 时,应将此属性设置为 false。

true

server.tomcat.relaxed-path-chars

允许在 URI 路径中出现的额外未编码字符列表。仅允许 "< > [ \ ] ^ ` { | }"。

server.tomcat.relaxed-query-chars

允许在 URI 查询字符串中出现的额外未编码字符列表。仅允许 "< > [ \ ] ^ ` { | }"。

server.tomcat.remoteip.host-header

从中提取远程主机的 HTTP 头名称。

X-Forwarded-Host

server.tomcat.remoteip.internal-proxies

匹配应受信任的代理的正则表达式。

10\\.\\d{1,3}\\.\\d{1,3}\\.\\d{1,3}|192\\.168\\.\\d{1,3}\\.\\d{1,3}|169\\.254\\.\\d{1,3}\\.\\d{1,3}|127\\.\\d{1,3}\\.\\d{1,3}\\.\\d{1,3}|100\\.6[4-9]{1}\\.\\d{1,3}\\.\\d{1,3}|100\\.[7-9]{1}\\d{1}\\.\\d{1,3}\\.\\d{1,3}|100\\.1[0-1]{1}\\d{1}\\.\\d{1,3}\\.\\d{1,3}|100\\.12[0-7]{1}\\.\\d{1,3}\\.\\d{1,3}|172\\.1[6-9]{1}\\.\\d{1,3}\\.\\d{1,3}|172\\.2[0-9]{1}\\.\\d{1,3}\\.\\d{1,3}|172\\.3[0-1]{1}\\.\\d{1,3}\\.\\d{1,3}|0:0:0:0:0:0:0:1|::1|fe[89ab]\\p{XDigit}:.*|f[cd]\\p{XDigit}{2}:.*+

server.tomcat.remoteip.port-header

用于覆盖原始端口值的 HTTP 头名称。

X-Forwarded-Port

server.tomcat.remoteip.protocol-header

包含传入协议的头,通常命名为 "X-Forwarded-Proto"。

server.tomcat.remoteip.protocol-header-https-value

协议头的值,指示传入请求是否使用 SSL。

https

server.tomcat.remoteip.remote-ip-header

从中提取远程 IP 的 HTTP 头名称。例如,'X-FORWARDED-FOR'。

server.tomcat.remoteip.trusted-proxies

定义在 "remote-ip-header" 头中出现时被信任的代理的正则表达式。

server.tomcat.resource.allow-caching

是否允许此 Web 应用程序进行静态资源缓存。

true

server.tomcat.resource.cache-ttl

静态资源缓存的生存时间 (TTL)。

server.tomcat.threads.max

最大工作线程数。如果启用了虚拟线程,则无效。

200

server.tomcat.threads.max-queue-capacity

线程池后台队列的最大容量。此设置仅在值大于 0 时有效。

2147483647

server.tomcat.threads.min-spare

最小工作线程数。如果启用了虚拟线程,则无效。

10

server.tomcat.uri-encoding

用于解码 URI 的字符编码。

UTF-8

server.tomcat.use-apr

是否使用 APR。如果在 Java 24 以下运行,默认值为 'WHEN_AVAILABLE'。在 Java 24 或更高版本上,默认值为 'NEVER'。

server.tomcat.use-relative-redirects

HTTP 1.1 及更高版本中,由 sendRedirect 调用生成的 Location 头是否使用相对重定向或绝对重定向。

false

server.undertow.accesslog.dir

Undertow 访问日志目录。

server.undertow.accesslog.enabled

是否启用访问日志。

false

server.undertow.accesslog.pattern

访问日志的格式模式。

common

server.undertow.accesslog.prefix

日志文件名前缀。

access_log.

server.undertow.accesslog.rotate

是否启用访问日志轮换。

true

server.undertow.accesslog.suffix

日志文件名后缀。

log

server.undertow.always-set-keep-alive

是否应将 'Connection: keep-alive' 头添加到所有响应中,即使 HTTP 规范没有要求。

true

server.undertow.buffer-size

每个缓冲区的大小。默认值根据 JVM 可用的最大内存量得出。

server.undertow.decode-slash

是否应解码编码的斜杠字符 (%2F)。如果前端代理未执行相同的解码,则解码可能导致安全问题。仅当您有需要此功能的旧应用程序时才启用此功能。设置后,server.undertow.allow-encoded-slash 将不起作用。

server.undertow.decode-url

URL 是否应被解码。禁用时,URL 中的百分比编码字符将保持原样。

true

server.undertow.direct-buffers

是否在 Java 堆外部分配缓冲区。默认值根据 JVM 可用的最大内存量得出。

server.undertow.eager-filter-init

servlet 过滤器是否应在启动时初始化。

true

server.undertow.max-cookies

允许的最大 cookie 数量。此限制用于防止基于哈希冲突的 DOS 攻击。

200

server.undertow.max-headers

允许的最大头数量。此限制用于防止基于哈希冲突的 DOS 攻击。

server.undertow.max-http-post-size

HTTP post 内容的最大大小。当值为 -1(默认值)时,大小不受限制。

-1B

server.undertow.max-parameters

允许的最大查询或路径参数数量。此限制用于防止基于哈希冲突的 DOS 攻击。

server.undertow.no-request-timeout

连接在没有处理请求的情况下可以保持空闲状态的时间,超过此时间后将被服务器关闭。

server.undertow.options.server.*

io.undertow.UndertowOptions 中定义的服务器选项。

server.undertow.options.socket.*

org.xnio.Options 中定义的 Socket 选项。

server.undertow.preserve-path-on-forward

转发请求时是否保留其路径。

false

server.undertow.threads.io

为 worker 创建的 I/O 线程数。默认值根据可用处理器数量得出。

server.undertow.threads.worker

worker 线程数。默认值是 I/O 线程数的 8 倍。

server.undertow.url-charset

用于解码 URL 的字符集。

UTF-8

模板属性

名称 描述 默认值

spring.freemarker.allow-request-override

HttpServletRequest 属性是否允许覆盖(隐藏)控制器生成的同名模型属性。仅支持 Spring MVC。

false

spring.freemarker.allow-session-override

HttpSession 属性是否允许覆盖(隐藏)控制器生成的同名模型属性。仅支持 Spring MVC。

false

spring.freemarker.cache

是否启用模板缓存。仅支持 Spring MVC。

false

spring.freemarker.charset

模板编码。

UTF-8

spring.freemarker.check-template-location

是否检查模板位置是否存在。

true

spring.freemarker.content-type

Content-Type 值。仅支持 Spring MVC。

text/html

spring.freemarker.enabled

是否为此技术启用 MVC 视图解析。

true

spring.freemarker.expose-request-attributes

在与模板合并之前,是否应将所有请求属性添加到模型中。仅支持 Spring MVC。

false

spring.freemarker.expose-session-attributes

在与模板合并之前,是否应将所有 HttpSession 属性添加到模型中。仅支持 Spring MVC。

false

spring.freemarker.expose-spring-macro-helpers

是否公开一个 RequestContext,供 Spring 的宏库使用,名称为 "springMacroRequestContext"。仅支持 Spring MVC。

true

spring.freemarker.prefer-file-system-access

是否优先使用文件系统访问进行模板加载,以便热检测模板更改。当模板路径被检测为目录时,仅从该目录加载模板,不会考虑其他匹配的 classpath 位置。

false

spring.freemarker.prefix

构建 URL 时添加到视图名称前面的前缀。

spring.freemarker.request-context-attribute

所有视图的 RequestContext 属性名称。

spring.freemarker.settings.*

传递给 FreeMarker 的 Configuration 的知名 FreeMarker 键。

spring.freemarker.suffix

构建 URL 时添加到视图名称后面的后缀。

.ftlh

spring.freemarker.template-loader-path

模板路径列表。

[classpath:/templates/]

spring.freemarker.view-names

可解析的视图名称。

spring.groovy.template.allow-request-override

HttpServletRequest 属性是否允许覆盖(隐藏)控制器生成的同名模型属性。

false

spring.groovy.template.allow-session-override

HttpSession 属性是否允许覆盖(隐藏)控制器生成的同名模型属性。

false

spring.groovy.template.cache

是否启用模板缓存。

false

spring.groovy.template.charset

模板编码。

UTF-8

spring.groovy.template.check-template-location

是否检查模板位置是否存在。

true

spring.groovy.template.configuration.auto-escape
spring.groovy.template.configuration.auto-indent
spring.groovy.template.configuration.auto-indent-string
spring.groovy.template.configuration.auto-new-line
spring.groovy.template.configuration.base-template-class
spring.groovy.template.configuration.cache-templates
spring.groovy.template.configuration.declaration-encoding
spring.groovy.template.configuration.expand-empty-elements
spring.groovy.template.configuration.locale
spring.groovy.template.configuration.new-line-string
spring.groovy.template.configuration.resource-loader-path
spring.groovy.template.configuration.use-double-quotes

参见 GroovyMarkupConfigurer

spring.groovy.template.content-type

Content-Type 值。

text/html

spring.groovy.template.enabled

是否为此技术启用 MVC 视图解析。

true

spring.groovy.template.expose-request-attributes

在与模板合并之前,是否应将所有请求属性添加到模型中。

false

spring.groovy.template.expose-session-attributes

在与模板合并之前,是否应将所有 HttpSession 属性添加到模型中。

false

spring.groovy.template.expose-spring-macro-helpers

是否公开 RequestContext 以供 Spring 的宏库使用,名称为 "springMacroRequestContext"。

true

spring.groovy.template.prefix

构建 URL 时添加到视图名称前面的前缀。

spring.groovy.template.request-context-attribute

所有视图的 RequestContext 属性名称。

spring.groovy.template.resource-loader-path

模板路径。

classpath:/templates/

spring.groovy.template.suffix

构建 URL 时添加到视图名称后面的后缀。

.tpl

spring.groovy.template.view-names

可解析的视图名称。

spring.mustache.charset

模板编码。

UTF-8

spring.mustache.check-template-location

是否检查模板位置是否存在。

true

spring.mustache.enabled

是否启用 Mustache 的 MVC 视图解析。

true

spring.mustache.prefix

应用于模板名称的前缀。

classpath:/templates/

spring.mustache.reactive.media-types

Mustache 视图支持的媒体类型。

text/html;charset=UTF-8

spring.mustache.request-context-attribute

所有视图的 RequestContext 属性名称。

spring.mustache.servlet.allow-request-override

HttpServletRequest 属性是否允许覆盖(隐藏)控制器生成的同名模型属性。

false

spring.mustache.servlet.allow-session-override

HttpSession 属性是否允许覆盖(隐藏)控制器生成的同名模型属性。

false

spring.mustache.servlet.cache

是否启用模板缓存。

false

spring.mustache.servlet.content-type

Content-Type 值。

spring.mustache.servlet.expose-request-attributes

在与模板合并之前,是否应将所有请求属性添加到模型中。

false

spring.mustache.servlet.expose-session-attributes

在与模板合并之前,是否应将所有 HttpSession 属性添加到模型中。

false

spring.mustache.servlet.expose-spring-macro-helpers

是否公开 RequestContext 以供 Spring 的宏库使用,名称为 "springMacroRequestContext"。

true

spring.mustache.suffix

应用于模板名称的后缀。

.mustache

spring.mustache.view-names

可解析的视图名称。

spring.thymeleaf.cache

是否启用模板缓存。

true

spring.thymeleaf.check-template

在渲染模板之前是否检查它是否存在。

true

spring.thymeleaf.check-template-location

是否检查模板位置是否存在。

true

spring.thymeleaf.enable-spring-el-compiler

在 SpringEL 表达式中启用 SpringEL 编译器。

false

spring.thymeleaf.enabled

是否为 Web 框架启用 Thymeleaf 视图解析。

true

spring.thymeleaf.encoding

模板文件编码。

UTF-8

spring.thymeleaf.excluded-view-names

应从解析中排除的视图名称列表(允许模式)。

spring.thymeleaf.mode

应用于模板的模板模式。另请参见 Thymeleaf 的 TemplateMode 枚举。

HTML

spring.thymeleaf.prefix

构建 URL 时添加到视图名称前面的前缀。

classpath:/templates/

spring.thymeleaf.reactive.chunked-mode-view-names

以逗号分隔的视图名称列表(允许模式),当设置了最大块大小时,它们应该是唯一在 CHUNKED 模式下执行的视图。

spring.thymeleaf.reactive.full-mode-view-names

以逗号分隔的视图名称列表(允许模式),即使设置了最大块大小,也应在 FULL 模式下执行。

spring.thymeleaf.reactive.max-chunk-size

用于写入响应的数据缓冲区的最大大小。如果设置了此值,模板将默认在 CHUNKED 模式下执行。

0B

spring.thymeleaf.reactive.media-types

视图技术支持的媒体类型。

[text/html, application/xhtml+xml, application/xml, text/xml, application/rss+xml, application/atom+xml, application/javascript, application/ecmascript, text/javascript, text/ecmascript, application/json, text/css, text/plain, text/event-stream]

spring.thymeleaf.render-hidden-markers-before-checkboxes

充当复选框标记的隐藏表单输入是否应在复选框元素本身之前渲染。

false

spring.thymeleaf.servlet.content-type

写入 HTTP 响应的 Content-Type 值。

text/html

spring.thymeleaf.servlet.produce-partial-output-while-processing

Thymeleaf 是应尽快开始写入部分输出,还是缓冲直到模板处理完成。

true

spring.thymeleaf.suffix

构建 URL 时添加到视图名称后面的后缀。

.html

spring.thymeleaf.template-resolver-order

模板解析器在链中的顺序。默认情况下,模板解析器位于链中的第一个。顺序从 1 开始,只有在定义了额外的 "TemplateResolver" bean 时才应设置。

spring.thymeleaf.view-names

可解析的视图名称列表(允许模式)。

Testcontainers 属性

名称 描述 默认值

spring.testcontainers.beans.startup

Testcontainers 启动模式。

sequential

spring.testcontainers.dynamic-property-registry-injection

如何处理将 DynamicPropertyRegistry 注入到 @Bean 方法中。

fail

测试属性

名称 描述 默认值

spring.test.database.replace

要替换的现有 DataSource 类型。

any

spring.test.mockmvc.print

MVC 打印选项。

default

spring.test.observability.auto-configure

测试中是否应自动配置可观测性。

false

事务属性

名称 描述 默认值

spring.jta.enabled

是否启用 JTA 支持。

true

spring.transaction.default-timeout

默认事务超时时间。如果未指定持续时间后缀,则使用秒。

spring.transaction.rollback-on-commit-failure

提交失败时是否回滚。

Web 属性

名称 描述 默认值

spring.graphql.cors.allow-credentials

是否支持凭证。未设置时,不支持凭证。

spring.graphql.cors.allowed-headers

请求中允许的 HTTP 头列表。'*' 允许所有头。

spring.graphql.cors.allowed-methods

允许的 HTTP 方法列表。'*' 允许所有方法。未设置时,默认为 GET。

spring.graphql.cors.allowed-origin-patterns

允许的源模式列表。与仅支持 '*' 的允许源不同,源模式更灵活,例如 'https://*.example.com',并且可以与 allow-credentials 一起使用。当允许源和允许源模式均未设置时,跨域请求将实际禁用。

spring.graphql.cors.allowed-origins

允许的源列表,使用 '*' 允许所有源。当 allow-credentials 启用时,不能使用 '*',应考虑设置源模式。当允许源和允许源模式均未设置时,跨域请求将实际禁用。

spring.graphql.cors.exposed-headers

响应中要包含的头列表。

spring.graphql.cors.max-age

预检请求的响应可以被客户端缓存多久。如果未指定持续时间后缀,则使用秒为单位。

1800s

spring.graphql.graphiql.enabled

是否启用默认的 GraphiQL UI。

false

spring.graphql.graphiql.path

GraphiQL UI 端点的路径。

/graphiql

spring.graphql.path

公开 GraphQL 请求 HTTP 端点的路径。

/graphql

spring.graphql.rsocket.mapping

RSocket 消息处理程序的映射。

spring.graphql.schema.file-extensions

GraphQL schema 文件的文件扩展名。

.graphqls,.gqls

spring.graphql.schema.inspection.enabled

是否应将 schema 与应用程序进行比较以检测缺失的映射。

true

spring.graphql.schema.introspection.enabled

是否应在 schema 级别启用字段内省。

true

spring.graphql.schema.locations

GraphQL schema 文件的位置。

classpath:graphql/**/

spring.graphql.schema.printer.enabled

是否启用打印 schema 的端点。Schema 可在 spring.graphql.path + "/schema" 下访问。

false

spring.graphql.sse.timeout

并发处理完成所需的时间。

spring.graphql.websocket.connection-init-timeout

必须在此时间内接收到初始 {@code CONNECTION_INIT} 类型消息。

60s

spring.graphql.websocket.keep-alive

服务器向客户端发送 keep-alive ping 之前的最大空闲周期。

spring.graphql.websocket.path

GraphQL WebSocket 订阅端点的路径。

spring.hateoas.use-hal-as-default-json-media-type

是否应将 application/hal+json 响应发送给接受 application/json 的请求。

true

spring.http.client.connect-timeout

客户端 HTTP 请求的默认连接超时时间。

spring.http.client.factory

客户端 HTTP 请求使用的默认工厂。

spring.http.client.read-timeout

客户端 HTTP 请求的默认读取超时时间。

spring.http.client.redirects

HTTP 重定向处理。

follow-when-possible

spring.http.client.ssl.bundle

要使用的 SSL bundle。

spring.jersey.application-path

用作应用程序基本 URI 的路径。如果指定,将覆盖 "@ApplicationPath" 的值。

spring.jersey.filter.order

Jersey 过滤器链顺序。

0

spring.jersey.init.*

通过 servlet 或 filter 传递给 Jersey 的初始化参数。

spring.jersey.servlet.load-on-startup

Jersey servlet 的启动时加载优先级。

-1

spring.jersey.type

Jersey 集成类型。

servlet

spring.mvc.async.request-timeout

异步请求处理超时前的时间量。如果未设置此值,则使用底层实现的默认超时时间。

spring.mvc.contentnegotiation.favor-parameter

是否应使用请求参数(默认为 "format")来确定请求的媒体类型。

false

spring.mvc.contentnegotiation.media-types.*

将文件扩展名映射到用于内容协商的媒体类型。例如,将 yml 映射到 text/yaml。

spring.mvc.contentnegotiation.parameter-name

启用 "favor-parameter" 时使用的查询参数名称。

spring.mvc.converters.preferred-json-mapper

用于 HTTP 消息转换的首选 JSON 映射器。默认情况下,根据环境自动检测。支持的值有 'jackson'、'gson' 和 'jsonb'。当存在其他 JSON 映射库(如 kotlinx.serialization)时,请使用自定义 HttpMessageConverters bean 来控制首选映射器。

jackson

spring.mvc.dispatch-options-request

是否将 OPTIONS 请求分派到 FrameworkServlet 的 doService 方法。

true

spring.mvc.dispatch-trace-request

是否将 TRACE 请求分派到 FrameworkServlet 的 doService 方法。

false

spring.mvc.format.date

要使用的日期格式,例如 'dd/MM/yyyy'。用于格式化 java.util.Date 和 java.time.LocalDate。

spring.mvc.format.date-time

要使用的日期时间格式,例如 'yyyy-MM-dd HH:mm:ss'。用于格式化 java.time 的 LocalDateTime、OffsetDateTime 和 ZonedDateTime。

spring.mvc.format.time

要使用的时间格式,例如 'HH:mm:ss'。用于格式化 java.time 的 LocalTime 和 OffsetTime。

spring.mvc.formcontent.filter.enabled

是否启用 Spring 的 FormContentFilter。

true

spring.mvc.hiddenmethod.filter.enabled

是否启用 Spring 的 HiddenHttpMethodFilter。

false

spring.mvc.log-request-details

是否允许在 DEBUG 和 TRACE 级别记录(可能敏感的)请求详情。

false

spring.mvc.log-resolved-exception

是否启用由 "HandlerExceptionResolver" 解析的异常的警告日志记录,"DefaultHandlerExceptionResolver" 除外。

false

spring.mvc.message-codes-resolver-format

消息代码的格式化策略。例如,'PREFIX_ERROR_CODE'。

spring.mvc.pathmatch.matching-strategy

将请求路径与已注册映射匹配的策略选择。

path-pattern-parser

spring.mvc.problemdetails.enabled

是否应启用 RFC 9457 问题详情支持。

false

spring.mvc.publish-request-handled-events

是否在每个请求结束时发布 ServletRequestHandledEvent。

true

spring.mvc.servlet.load-on-startup

dispatcher servlet 的启动时加载优先级。

-1

spring.mvc.servlet.path

dispatcher servlet 的路径。为此属性设置自定义值与 PathPatternParser 匹配策略不兼容。

/

spring.mvc.static-path-pattern

用于静态资源的路径模式。

/**

spring.mvc.view.prefix

Spring MVC 视图前缀。

spring.mvc.view.suffix

Spring MVC 视图后缀。

spring.mvc.webjars-path-pattern

用于 WebJar 资源的路径模式。

/webjars/**

spring.netty.leak-detection

引用计数缓冲区的内存泄漏检测级别。如果未通过 'ResourceLeakDetector.setLevel' 或 'io.netty.leakDetection.level' 系统属性配置,默认为 'simple'。

spring.servlet.multipart.enabled

是否启用 multipart 上传支持。

true

spring.servlet.multipart.file-size-threshold

文件写入磁盘的阈值。

0B

spring.servlet.multipart.location

上传文件的中间位置。

spring.servlet.multipart.max-file-size

最大文件大小。

1MB

spring.servlet.multipart.max-request-size

最大请求大小。

10MB

spring.servlet.multipart.resolve-lazily

是否在访问文件或参数时延迟解析 multipart 请求。

false

spring.servlet.multipart.strict-servlet-compliance

是否严格按照 Servlet 规范解析 multipart 请求,仅用于 "multipart/form-data" 请求。

false

spring.session.hazelcast.flush-mode

Session 刷新模式。确定何时将 session 更改写入 session 存储。

on-save

spring.session.hazelcast.map-name

用于存储 session 的 map 名称。

spring:session:sessions

spring.session.hazelcast.save-mode

Session 保存模式。确定如何跟踪 session 更改并将其保存到 session 存储。

on-set-attribute

spring.session.jdbc.cleanup-cron

过期 session 清理作业的 Cron 表达式。

0 * * * * *

spring.session.jdbc.flush-mode

Session 刷新模式。确定何时将 session 更改写入 session 存储。

on-save

spring.session.jdbc.initialize-schema

数据库 schema 初始化模式。

embedded

spring.session.jdbc.platform

如果在初始化脚本中使用了 @@platform@@ 占位符,则使用此平台。默认自动检测。

spring.session.jdbc.save-mode

Session 保存模式。确定如何跟踪 session 更改并将其保存到 session 存储。

on-set-attribute

spring.session.jdbc.schema

用于初始化数据库 schema 的 SQL 文件路径。

classpath:org/springframework/session/jdbc/schema-@@platform@@.sql

spring.session.jdbc.table-name

用于存储 session 的数据库表名称。

SPRING_SESSION

spring.session.mongodb.collection-name

用于存储 session 的集合名称。

sessions

spring.session.redis.cleanup-cron

过期 session 清理作业的 Cron 表达式。仅在 repository-type 设置为 indexed 时支持。不支持 reactive session repository。

0 * * * * *

spring.session.redis.configure-action

当没有用户定义的 ConfigureRedisAction 或 ConfigureReactiveRedisAction bean 时应用的配置操作。

notify-keyspace-events

spring.session.redis.flush-mode

Session 刷新模式。确定何时将 session 更改写入 session 存储。不支持 reactive session repository。

on-save

spring.session.redis.namespace

用于存储 session 的键的命名空间。

spring:session

spring.session.redis.repository-type

要配置的 Redis session 存储库类型。

default

spring.session.redis.save-mode

Session 保存模式。确定如何跟踪 session 更改并将其保存到 session 存储。

on-set-attribute

spring.session.servlet.filter-dispatcher-types

Session 存储库过滤器分派器类型。

[async, error, request]

spring.session.servlet.filter-order

Session 存储库过滤器顺序。

spring.session.timeout

会话超时时间。如果未指定持续时间后缀,将使用秒作为单位。

spring.web.locale

要使用的区域设置。默认情况下,此区域设置会被 "Accept-Language" 头覆盖。

spring.web.locale-resolver

定义如何解析区域设置。

accept-header

spring.web.resources.add-mappings

是否启用默认资源处理。

true

spring.web.resources.cache.cachecontrol.cache-private

指示响应消息仅供单个用户使用,不得由共享缓存存储。

spring.web.resources.cache.cachecontrol.cache-public

指示任何缓存都可以存储响应。

spring.web.resources.cache.cachecontrol.max-age

响应应缓存的最长时间,如果未指定持续时间后缀,则使用秒。

spring.web.resources.cache.cachecontrol.must-revalidate

指示一旦响应变为陈旧,缓存必须在不与服务器重新验证的情况下不使用响应。

spring.web.resources.cache.cachecontrol.no-cache

指示仅在与服务器重新验证后,才能重用缓存的响应。

spring.web.resources.cache.cachecontrol.no-store

指示在任何情况下都不要缓存响应。

spring.web.resources.cache.cachecontrol.no-transform

指示中介(缓存及其他)不应转换响应内容。

spring.web.resources.cache.cachecontrol.proxy-revalidate

与 "must-revalidate" 指令含义相同,但它不适用于私有缓存。

spring.web.resources.cache.cachecontrol.s-max-age

响应应由共享缓存缓存的最长时间,如果未指定持续时间后缀,则使用秒。

spring.web.resources.cache.cachecontrol.stale-if-error

遇到错误时响应可能使用的最长时间,如果未指定持续时间后缀,则使用秒。

spring.web.resources.cache.cachecontrol.stale-while-revalidate

响应在变陈旧后可以被提供服务的最大时间,如果未指定持续时间后缀,则使用秒。

spring.web.resources.cache.period

资源处理器提供的资源的缓存周期。如果未指定持续时间后缀,则使用秒。可通过 'spring.web.resources.cache.cachecontrol' 属性覆盖。

spring.web.resources.cache.use-last-modified

是否应在 HTTP 缓存头中使用文件的 "lastModified" 元数据。

true

spring.web.resources.chain.cache

是否在资源链中启用缓存。

true

spring.web.resources.chain.compressed

是否启用已压缩资源(gzip, brotli)的解析。检查资源名称是否带有 '.gz' 或 '.br' 文件扩展名。

false

spring.web.resources.chain.enabled

是否启用 Spring 资源处理链。默认情况下禁用,除非至少启用了一种策略。

spring.web.resources.chain.strategy.content.enabled

是否启用内容版本策略。

false

spring.web.resources.chain.strategy.content.paths

应用于内容版本策略的模式列表。

[/**]

spring.web.resources.chain.strategy.fixed.enabled

是否启用固定版本策略。

false

spring.web.resources.chain.strategy.fixed.paths

应用于固定版本策略的模式列表。

[/**]

spring.web.resources.chain.strategy.fixed.version

固定版本策略使用的版本字符串。

spring.web.resources.static-locations

静态资源的位置。默认为 classpath:[/META-INF/resources/, /resources/, /static/, /public/]。

[classpath:/META-INF/resources/, classpath:/resources/, classpath:/static/, classpath:/public/]

spring.webflux.base-path

所有 Web 处理器的基本路径。

spring.webflux.format.date

要使用的日期格式,例如 'dd/MM/yyyy'。用于格式化 java.util.Date 和 java.time.LocalDate。

spring.webflux.format.date-time

要使用的日期时间格式,例如 'yyyy-MM-dd HH:mm:ss'。用于格式化 java.time 的 LocalDateTime、OffsetDateTime 和 ZonedDateTime。

spring.webflux.format.time

要使用的时间格式,例如 'HH:mm:ss'。用于格式化 java.time 的 LocalTime 和 OffsetTime。

spring.webflux.hiddenmethod.filter.enabled

是否启用 Spring 的 HiddenHttpMethodFilter。

false

spring.webflux.multipart.file-storage-directory

用于存储大于 'maxInMemorySize' 的文件部分的目录。默认为在系统临时目录下创建名为 'spring-multipart' 的目录。使用 PartEvent 流式支持时忽略此设置。

spring.webflux.multipart.headers-charset

用于解码请求头的字符集。

UTF-8

spring.webflux.multipart.max-disk-usage-per-part

每个文件部分允许的最大磁盘空间量。默认为 -1,表示没有限制。

-1B

spring.webflux.multipart.max-headers-size

每个文件部分请求头部分允许的最大内存量。设置为 -1 表示没有限制。

10KB

spring.webflux.multipart.max-in-memory-size

在写入磁盘之前,每个文件部分允许的最大内存量。设置为 -1 表示将所有内容存储在内存中。

256KB

spring.webflux.multipart.max-parts

在一个给定的 multipart 请求中允许的最大文件部分数。默认为 -1,表示没有限制。

-1

spring.webflux.problemdetails.enabled

是否应启用 RFC 9457 问题详情支持。

false

spring.webflux.static-path-pattern

用于静态资源的路径模式。

/**

spring.webflux.webjars-path-pattern

用于 WebJar 资源的路径模式。

/webjars/**