本站内所有文档均为中英对照文档，点击中文可以显示英文。此提醒连续关闭5次后，将不再显示。
常见应用属性
常用应用程序属性
可以在你的 application.properties 文件、application.yaml 文件中，或作为命令行开关指定各种属性。本附录列出了常见的 Spring Boot 属性，并引用了使用这些属性的底层类。
提示
Spring Boot 提供了多种转换机制，并支持高级值格式化。请务必查看属性转换部分。
备注
属性贡献可能来自 classpath 上的额外 jar 文件，因此你不应将此视为详尽无遗的列表。此外，你也可以定义自己的属性。
Actuator 属性
缓存属性
| 名称 | 描述 | 默认值 |
|---|---|---|
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 | 缓存类型。默认情况下，根据环境自动检测。 |
核心属性
数据迁移属性
数据属性
| 名称 | 描述 | 默认值 |
|---|---|---|
spring.cassandra.compression | Cassandra 二进制协议支持的压缩方式。 | none |
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 | 被视为“本地”的数据中心。联系点应来自此数据中心。 | |
spring.cassandra.password | 服务器的登录密码。 | |
spring.cassandra.pool.heartbeat-interval | 心跳间隔，空闲连接在此时间后发送消息以确保其仍处于活动状态。 | 30s |
spring.cassandra.pool.idle-timeout | 空闲连接在被移除前的空闲超时时间。 | 5s |
spring.cassandra.port | 如果联系点未指定端口，则使用此端口。 | 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 | 请求限流类型。 | none |
spring.cassandra.request.timeout | 驱动程序等待请求完成的时间。 | 2s |
spring.cassandra.schema-action | 启动时要执行的 Schema 操作。 | none |
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.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 | 每个节点的最大套接字数量。 | 12 |
spring.couchbase.env.io.min-endpoints | 每个节点的最小套接字数量。 | 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 | Bucket 连接超时。 | 10s |
spring.couchbase.env.timeouts.disconnect | Bucket 断开连接超时。 | 10s |
spring.couchbase.env.timeouts.key-value | 对特定键值操作的超时时间。 | 2500ms |
spring.couchbase.env.timeouts.key-value-durable | 对具有持久性级别的特定键值操作的超时时间。 | 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.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 仓库的 Bootstrap 模式。 | default |
spring.data.jpa.repositories.enabled | 是否启用 JPA 仓库。 | true |
spring.data.ldap.repositories.enabled | 是否启用 LDAP 仓库。 | true |
spring.data.mongodb.auto-index-creation | 是否启用自动索引创建。 | |
spring.data.mongodb.field-naming-strategy | 要使用的 FieldNamingStrategy 的完全限定名称。 | |
spring.data.mongodb.gridfs.bucket | GridFS 存储桶名称。 | |
spring.data.mongodb.gridfs.database | GridFS 数据库名称。 | |
spring.data.mongodb.repositories.type | 要启用的 Mongo 仓库类型。 | auto |
spring.data.mongodb.representation.big-decimal | 转换 BigDecimal 时使用的表示形式。 | unspecified |
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，在哨兵模式下连接池是隐式启用的，此设置仅适用于单节点配置。 | |
spring.data.redis.jedis.pool.max-active | 池在给定时间内可分配的最大连接数。使用负值表示无限制。 | 8 |
spring.data.redis.jedis.pool.max-idle | 池中“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，在哨兵模式下连接池是隐式启用的，此设置仅适用于单节点配置。 | |
spring.data.redis.lettuce.pool.max-active | 池在给定时间内可分配的最大连接数。使用负值表示无限制。 | 8 |
spring.data.redis.lettuce.pool.max-idle | 池中“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.read-from | 定义从哪些 Redis 节点读取数据。 | |
spring.data.redis.lettuce.shutdown-timeout | 关闭超时。 | 100ms |
spring.data.redis.masterreplica.nodes | 静态的 "host:port" 对列表，至少需要一个条目。 | |
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 和 database。示例：redis://user:password@example.com:6379/8 | |
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-ignore-sql-codes | ||
| spring.datasource.dbcp2.disconnection-sql-codes | ||
| 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](#application-properties.data.spring.datasource.dbcp2) | Commons DBCP2 特定设置，绑定到 DBCP2 的 BasicDataSource 实例 | |
spring.datasource.driver-class-name | JDBC 驱动的全限定名称。默认情况下根据 URL 自动检测。 | |
spring.datasource.embedded-database-connection | 嵌入式数据库的连接详情。默认使用类路径中可用的最合适的嵌入式数据库。 | |
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.credentials-provider-class-name | ||
| 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.minimum-idle | ||
| spring.datasource.hikari.password | ||
| spring.datasource.hikari.pool-name | ||
| spring.datasource.hikari.read-only | ||
| spring.datasource.hikari.register-mbeans | ||
| spring.datasource.hikari.schema | ||
| spring.datasource.hikari.transaction-isolation | ||
| spring.datasource.hikari.username | ||
| spring.datasource.hikari.validation-timeout](#application-properties.data.spring.datasource.hikari) | Hikari 特定设置绑定到 Hikari 的 HikariDataSource 实例 | |
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.commit-on-connection-return | ||
| 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-timeout-while-service-down | ||
| 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.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](#application-properties.data.spring.datasource.oracleucp) | Oracle UCP 特定设置绑定到 Oracle UCP 的 PoolDataSource 实例 | |
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](#application-properties.data.spring.datasource.tomcat) | Tomcat 数据源特定设置，绑定到 Tomcat JDBC 的 DataSource 实例 | |
spring.datasource.type | 要使用的 DataSource 实现的全限定名称。默认情况下，会从 classpath 中自动检测连接池实现。 | |
spring.datasource.url | 数据库的 JDBC URL。 | |
spring.datasource.username | 数据库的登录用户名。 | |
spring.datasource.xa.data-source-class-name | XA 数据源的全限定名称。 | |
spring.datasource.xa.properties.* | 传递给 XA 数据源的属性。 | |
spring.elasticsearch.api-key | 用于与 Elasticsearch 进行身份验证的 API 密钥。 | |
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.enabled | 嗅探器是否启用。 | false |
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 Console 的偏好设置和工具的密码。 | |
spring.h2.console.settings.web-allow-others | 是否启用远程访问。 | false |
spring.jdbc.template.fetch-size | 当需要更多行时，应从数据库中获取的行数。使用 -1 以使用 JDBC 驱动程序的默认配置。 | -1 |
spring.jdbc.template.ignore-warnings | 是否忽略 JDBC 语句警告（SQLWarning）。当设置为 false 时，将抛出 SQLWarningException。 | true |
spring.jdbc.template.max-rows | 最大行数。使用 -1 表示采用 JDBC 驱动程序的默认配置。 | -1 |
spring.jdbc.template.query-timeout | 查询超时。默认使用 JDBC 驱动程序的默认配置。如果未指定持续时间后缀，则使用秒。 | |
spring.jdbc.template.results-map-case-insensitive | 执行 CallableStatement 时，是否将结果返回到一个使用不区分大小写的参数名称的 Map 中。 | false |
spring.jdbc.template.skip-results-processing | 是否应跳过结果处理。当已知没有返回结果时，可用于优化可调用语句的处理。 | false |
spring.jdbc.template.skip-undeclared-results | 未声明的结果是否应被跳过。 | false |
spring.jooq.config | jOOQ 配置文件的位置。 | |
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 | 是否在启动时初始化 schema。 | false |
spring.jpa.hibernate.ddl-auto | DDL 模式。这实际上是 "hibernate.hbm2ddl.auto" 属性的快捷方式。当使用嵌入式数据库且未检测到 schema 管理器时，默认为 "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 | Embedded LDAP 用户名。 | |
spring.ldap.embedded.ldif | Schema (LDIF) 脚本资源引用。 | classpath:schema.ldif |
spring.ldap.embedded.port | Embedded LDAP 端口。 | 0 |
spring.ldap.embedded.validation.enabled | 是否启用 LDAP 模式验证。 | true |
spring.ldap.embedded.validation.schema | 自定义 schema 的路径。 | |
spring.ldap.password | 服务器的登录密码。 | |
spring.ldap.referral | 指定服务提供者遇到的引用应如何处理。如果未指定，则默认值由提供者决定。 | |
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.mongodb.additional-hosts | 额外的服务器主机。如果设置了 'uri' 或省略了 'host'，则忽略此选项。额外的主机将使用默认的 MongoDB 端口 27017。如果想使用不同的端口，可以使用 "host:port" 语法。 | |
spring.mongodb.authentication-database | 认证数据库名称。 | |
spring.mongodb.database | 数据库名称。覆盖 URI 中的数据库。 | |
spring.mongodb.host | Mongo 服务器主机。如果设置了 'uri'，则忽略此选项。 | |
spring.mongodb.password | Mongo 服务器的登录密码。如果设置了 'uri'，则忽略此参数。 | |
spring.mongodb.port | Mongo 服务器端口。如果设置了 'uri'，则忽略此选项。 | |
spring.mongodb.protocol | 用于 MongoDB 连接的协议。如果设置了 'uri'，则此选项将被忽略。 | mongodb |
spring.mongodb.replica-set-name | 集群所需的副本集名称。如果设置了 'uri'，则忽略此选项。 | |
spring.mongodb.representation.uuid | 将 UUID 转换为 BSON 二进制值时使用的表示形式。 | unspecified |
spring.mongodb.ssl.bundle | SSL bundle 名称。 | |
spring.mongodb.ssl.enabled | 是否启用 SSL 支持。除非另有指定，否则在提供 "bundle" 时会自动启用。 | |
spring.mongodb.uri | Mongo 数据库 URI。会覆盖 host、port、username 和 password。 | mongodb://localhost/test |
spring.mongodb.username | Mongo 服务器的登录用户。如果设置了 'uri'，则忽略此参数。 | |
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.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.persistence.exceptiontranslation.enabled | 是否启用 PersistenceExceptionTranslationPostProcessor。 | true |
spring.r2dbc.generate-unique-name | 是否生成随机的数据库名称。启用时忽略任何已配置的名称。 | false |
spring.r2dbc.name | 数据库名称。如果在 URL 中未指定名称，则设置此参数。使用嵌入式数据库时，默认为 "testdb"。 | |
spring.r2dbc.password | 数据库的登录密码。如果 URL 中未指定密码，则设置此项。 | |
spring.r2dbc.pool.acquire-retry | 如果首次获取尝试失败，重试获取的次数。 | 1 |
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 属性
Docker Compose 属性
集成属性
JSON 属性
Mail Properties
| 名称 | 描述 | 默认值 |
|---|---|---|
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> 注意：即使未设置 'mail.(protocol).ssl.enable' 属性，STARTTLS 命令仍可使用对应的 SSLSocketFactory。 | |
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 属性
安全属性
服务器属性
模板属性
Testcontainers 属性
| 名称 | 描述 | 默认值 |
|---|---|---|
spring.testcontainers.beans.startup | Testcontainers 启动模式。 | sequential |
spring.testcontainers.dynamic-property-registry-injection | 如何处理将 DynamicPropertyRegistry 注入 @Bean 方法。 | fail |
测试属性
事务属性
| 名称 | 描述 | 默认值 |
|---|---|---|
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 时，不能使用 ''，应考虑设置源模式（origin patterns）。当既未设置允许的源也未设置允许的源模式时，跨域请求将被有效禁用。 | |
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.http.path | 用于暴露 GraphQL 请求 HTTP 端点的路径。 | /graphql |
spring.graphql.http.sse.keep-alive | keep-alive 消息应以多频繁的频率发送。 | |
spring.graphql.http.sse.timeout | 并发处理完成所需的时间。 | |
spring.graphql.rsocket.mapping | RSocket 消息处理器的映射。 | |
spring.graphql.rsocket.preferred-json-mapper | 首选的 JSON 映射器。默认情况下，根据环境自动检测。支持的值为 'jackson' 和 'jackson2'（已弃用）。 | jackson |
spring.graphql.schema.additional-files | 要解析的额外单个 schema 文件的位置。 | [] |
spring.graphql.schema.file-extensions | GraphQL 模式文件的文件扩展名。 | .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.http.path + "/schema" 下获取。 | false |
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.clients.connect-timeout | 客户端 HTTP 请求的默认连接超时时间。 | |
spring.http.clients.imperative.factory | 客户端 HTTP 请求使用的默认工厂。 | |
spring.http.clients.reactive.connector | 客户端 HTTP 请求使用的默认连接器。 | |
spring.http.clients.read-timeout | 客户端 HTTP 请求的默认读取超时时间。 | |
spring.http.clients.redirects | 处理 HTTP 重定向。 | |
spring.http.clients.ssl.bundle | 要使用的 SSL 证书包。 | |
spring.http.codecs.log-request-details | 是否在 DEBUG 级别记录表单数据，并在 TRACE 级别记录 headers。 | false |
spring.http.codecs.max-in-memory-size | 当输入流需要聚合时，可缓冲的字节数上限。此设置仅适用于自动配置的 WebFlux 服务器和 WebClient 实例。默认情况下未设置此值，此时将应用各个编解码器的默认限制。大多数编解码器默认限制为 256K。 | |
spring.http.codecs.preferred-json-mapper | 用于 HTTP 编码和解码的首选 JSON 映射器。默认情况下，根据环境自动检测。支持的值为 'jackson' 和 'jackson2'（已弃用）。 | jackson |
spring.http.converters.preferred-json-mapper | 用于 HTTP 消息转换的首选 JSON 映射器。默认情况下，根据环境自动检测。支持的值为 'jackson'、'jackson2'（已弃用）、'gson' 和 'jsonb'。当存在其他 JSON 映射库时，请使用自定义的 HttpMessageConverters Bean 来控制首选映射器。 | jackson |
spring.http.converters.string-encoding-charset | 用于字符串转换的字符集。 | UTF-8 |
spring.http.serviceclient.* | HTTP 服务客户端定义 | |
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.apiversion.default | 每个请求应使用的默认版本。 | |
spring.mvc.apiversion.detect-supported | 是否应从控制器中检测支持的版本。 | |
spring.mvc.apiversion.required | 每个请求是否都需要 API 版本。 | |
spring.mvc.apiversion.supported | 支持的版本。 | |
spring.mvc.apiversion.use.header | 使用指定名称的 HTTP 头来获取版本。 | |
spring.mvc.apiversion.use.media-type-parameter.* | 使用给定名称的媒体类型参数来获取版本。 | |
spring.mvc.apiversion.use.path-segment | 使用给定索引处的路径段来获取版本。 | |
spring.mvc.apiversion.use.query-parameter | 使用给定名称的查询参数来获取版本。 | |
spring.mvc.async.request-timeout | 异步请求处理超时前的时间。如果未设置此值，则使用底层实现的默认超时时间。 | |
spring.mvc.contentnegotiation.default-content-types | 当未请求特定内容类型时，使用的默认内容类型列表。 | |
spring.mvc.contentnegotiation.favor-parameter | 是否应使用请求参数（默认为 "format"）来确定所请求的媒体类型。 | false |
spring.mvc.contentnegotiation.media-types.* | 为内容协商将文件扩展名映射到媒体类型。例如，yml 映射为 text/yaml。 | |
spring.mvc.contentnegotiation.parameter-name | 当启用 "favor-parameter" 时使用的查询参数名称。 | |
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 Problem Details 支持。 | false |
spring.mvc.publish-request-handled-events | 是否在每个请求结束时发布一个 ServletRequestHandledEvent。 | true |
spring.mvc.servlet.load-on-startup | Dispatcher Servlet 的启动加载优先级。 | -1 |
spring.mvc.servlet.path | DispatcherServlet 的路径。为此属性设置自定义值与 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.encoding.charset | HTTP 请求和响应的字符集。如果未显式设置，则添加到 "Content-Type" 头中。 | UTF-8 |
spring.servlet.encoding.enabled | 是否启用 Servlet HTTP 编码支持。 | true |
spring.servlet.encoding.force | 是否强制在 HTTP 请求和响应中使用配置的字符集编码。 | |
spring.servlet.encoding.force-request | 是否强制将 HTTP 请求的编码设置为配置的字符集。当未指定 "force" 时，默认为 true。 | |
spring.servlet.encoding.force-response | 是否强制将 HTTP 响应的编码设置为配置的字符集。 | |
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.data.redis.cleanup-cron | 过期会话清理任务的 Cron 表达式。仅在 repository-type 设置为 indexed 时支持。不支持响应式会话仓库。 | 0 * * * * * |
spring.session.data.redis.configure-action | 当不存在用户自定义的 ConfigureRedisAction 或 ConfigureReactiveRedisAction Bean 时，要应用的配置操作。 | notify-keyspace-events |
spring.session.data.redis.flush-mode | 会话刷新模式。决定何时将会话更改写入会话存储。不支持响应式会话仓库。 | on-save |
spring.session.data.redis.namespace | 用于存储会话的键的命名空间。 | spring:session |
spring.session.data.redis.repository-type | 要配置的 Redis 会话仓库类型。 | default |
spring.session.data.redis.save-mode | 会话保存模式。决定如何跟踪会话更改并将其保存到会话存储中。 | on-set-attribute |
spring.session.jdbc.cleanup-cron | 过期会话清理任务的 Cron 表达式。 | 0 * * * * * |
spring.session.jdbc.continue-on-error | 在应用 schema 脚本时发生错误，是否应继续初始化。 | true |
spring.session.jdbc.flush-mode | Sessions flush mode. Determines when session changes are written to the session store. | on-save |
spring.session.jdbc.initialize-schema | 数据库模式初始化模式。 | embedded |
spring.session.jdbc.platform | 如果初始化脚本中使用了 @@platform@@ 占位符，则指定要使用的平台。默认情况下自动检测。 | |
spring.session.jdbc.save-mode | 会话保存模式。决定如何跟踪会话更改并将其保存到会话存储中。 | on-set-attribute |
spring.session.jdbc.schema | 用于初始化数据库模式的 SQL 文件路径。 | |
spring.session.jdbc.table-name | 用于存储会话的数据库表名称。 | SPRING_SESSION |
spring.session.servlet.filter-dispatcher-types | Session repository filter 的 dispatcher 类型。 | [async, error, request] |
spring.session.servlet.filter-order | Session repository 过滤器顺序。 | |
spring.session.timeout | 会话超时。如果未指定持续时间后缀，则使用秒。 | |
spring.web.error.include-binding-errors | 何时包含 "errors" 属性。 | never |
spring.web.error.include-exception | 包含 "exception" 属性。 | false |
spring.web.error.include-message | 何时包含 "message" 属性。 | never |
spring.web.error.include-path | 何时包含 "path" 属性。 | always |
spring.web.error.include-stacktrace | 何时包含 "trace" 属性。 | never |
spring.web.error.path | 错误控制器的路径。 | /error |
spring.web.error.whitelabel.enabled | 在服务器发生错误时，是否启用浏览器中显示的默认错误页面。 | true |
spring.web.locale | 要使用的语言环境。默认情况下，此语言环境会被 "Accept-Language" 头部覆盖。 | |
spring.web.locale-resolver | 定义 locale 应如何解析。 | 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 | 是否在 Resource 链中启用缓存。 | 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.apiversion.default | 每个请求应使用的默认版本。 | |
spring.webflux.apiversion.detect-supported | 是否应从控制器中检测支持的版本。 | |
spring.webflux.apiversion.required | 每个请求是否都需要 API 版本。 | |
spring.webflux.apiversion.supported | 支持的版本。 | |
spring.webflux.apiversion.use.header | 使用指定名称的 HTTP 头来获取版本。 | |
spring.webflux.apiversion.use.media-type-parameter.* | 使用给定名称的媒体类型参数来获取版本。 | |
spring.webflux.apiversion.use.path-segment | 使用给定索引处的路径段来获取版本。 | |
spring.webflux.apiversion.use.query-parameter | 使用给定名称的查询参数来获取版本。 | |
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 | 用于解码 headers 的字符集。 | UTF-8 |
spring.webflux.multipart.max-disk-usage-per-part | 每个部分允许的最大磁盘空间。默认值为 -1，表示不设限制。 | -1B |
spring.webflux.multipart.max-headers-size | 每个部分的 headers 部分允许的最大内存数量。设置为 -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 Problem Details 支持。 | false |
spring.webflux.static-path-pattern | 用于静态资源的路径模式。 | /** |
spring.webflux.webjars-path-pattern | 用于 WebJar 资源的路径模式。 | /webjars/** |
spring.websocket.messaging.preferred-json-mapper | 用于 WebSocket 消息传递的首选 JSON 映射器。默认情况下，根据环境自动检测。支持的值为 'jackson' 和 'jackson2'（已弃用）。 | jackson |