本站内所有文档均为中英对照文档，点击中文可以显示英文。此提醒连续关闭5次后，将不再显示。
通用应用程序属性
通用应用属性
可以在你的 application.properties 文件、application.yaml 文件中，或作为命令行开关来指定各种属性。本附录列出了常见的 Spring Boot 属性，并引用了使用这些属性的底层类。
提示
Spring Boot 提供了多种转换机制，并支持高级的值格式化。请务必查阅属性转换部分。
备注
属性贡献可能来自类路径（classpath）上的额外 jar 文件，因此你不应将此视为详尽无遗的列表。此外，你也可以定义自己的属性。
Actuator 属性
Cache Properties
| 名称 | 描述 | 默认值 |
|---|---|---|
spring.cache.cache-names | 要创建的缓存名称列表（如果底层缓存管理器支持）。通常，这会禁用动态创建额外缓存的能力。 | |
spring.cache.caffeine.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 | 缓存类型。默认情况下，根据环境自动检测。 |
Core Properties
| 名称 | 描述 | 默认值 |
|---|---|---|
debug | 启用调试日志。 | false |
info.* | 要添加到 info 端点的任意属性。 | |
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.* | 日志组（log groups）可用于同时快速更改多个记录器（logger）。例如，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 | 用于创建复合配置的覆盖配置文件。可以加上前缀 optional:，仅在覆盖文件存在时才加载。 | |
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 | 在日志系统初始化时注册一个关闭钩子（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 | Structured GELF host（默认为 'spring.application.name'）。 | |
logging.structured.gelf.service.version | 结构化 GELF 服务版本（默认为 'spring.application.version'）。 | |
logging.structured.json.add.* | 应添加到结构化日志 JSON 中的额外成员 | |
logging.structured.json.context.include | 是否应在 JSON 中包含上下文数据。 | |
logging.structured.json.context.prefix | 插入上下文数据时使用的前缀。 | |
logging.structured.json.customizer | StructuredLoggingJsonMembersCustomizer 实现的全限定类名 | |
logging.structured.json.exclude | 应从结构化日志 JSON 中排除的成员路径 | |
logging.structured.json.include | 应包含在结构化日志 JSON 中的成员路径 | |
logging.structured.json.rename.* | 成员路径与结构化日志 JSON 中应使用的替代名称之间的映射 | |
logging.structured.json.stacktrace.include-common-frames | 是否应包含通用帧。 | |
logging.structured.json.stacktrace.include-hashes | 是否应包含堆栈跟踪哈希。 | |
logging.structured.json.stacktrace.max-length | 要打印的最大长度。 | |
logging.structured.json.stacktrace.max-throwable-depth | 要打印的最大可抛出深度。 | |
logging.structured.json.stacktrace.printer | 要使用的打印机名称。可以是 'standard'、'logging-system'，或者一个 StackTracePrinter 的全限定类名。当未指定时，将根据是否设置了其他属性来决定使用 'logging-system' 或 'standard'。 | |
logging.structured.json.stacktrace.root | 根节点排序（根节点在前或根节点在后）。 | |
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 | 应用程序版本（默认为清单文件中的 'Implementation-Version'）。 | |
spring.autoconfigure.exclude | 要排除的自动配置类。 | |
spring.banner.charset | Banner 文件编码。 | UTF-8 |
spring.banner.location | Banner 文本资源位置。 | classpath:banner.txt |
spring.beaninfo.ignore | 是否跳过 BeanInfo 类的搜索。 | true |
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 | 应用程序是否应注册一个 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 列表（本质上是完全限定的类路径位置），每个都遵循 ResourceBundle 的约定，并对基于斜杠的位置提供宽松的支持。如果其中不包含包限定符（例如 "org.mypackage"），则将从类路径根目录进行解析。 | [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 | 以逗号分隔的激活配置文件列表。可通过命令行开关进行覆盖。 | |
spring.profiles.default | 如果没有激活的 profile，则启用的 profile 名称。 | default |
spring.profiles.group.* | 配置文件组（Profile groups）用于为一组相关的配置文件定义一个逻辑名称。 | |
spring.profiles.include | 无条件激活指定的逗号分隔的 profile 列表（如果使用 YAML，则为 profile 列表）。 | |
spring.profiles.validate | 是否应验证配置文件以确保使用了合理的名称。 | true |
spring.quartz.auto-startup | 是否在初始化后自动启动调度器。 | true |
spring.quartz.jdbc.comment-prefix | SQL 初始化脚本中单行注释的前缀。 | [#, --] |
spring.quartz.jdbc.initialize-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.* | Additional Quartz Scheduler properties. | |
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 keystore SSL 信任材料。 | |
spring.ssl.bundle.pem.* | PEM 编码的 SSL 信任材料。 | |
spring.ssl.bundle.watch.file.quiet-period | 静默期，之后会检测到变更。 | 10s |
spring.task.execution.mode | 确定任务执行器的创建时机。 | auto |
spring.task.execution.pool.allow-core-thread-timeout | 是否允许核心线程超时。这使得线程池能够动态地扩大和缩小。如果启用了虚拟线程（virtual threads），则此设置无效。 | true |
spring.task.execution.pool.core-size | 核心线程数。如果启用了虚拟线程，则此设置无效。 | 8 |
spring.task.execution.pool.keep-alive | 线程在被终止前可以保持空闲的时间限制。如果启用了虚拟线程（virtual threads），则此设置无效。 | 60s |
spring.task.execution.pool.max-size | 允许的最大线程数。如果任务填满了队列，线程池可以扩展到该大小以适应负载。如果队列是无界队列，则此参数被忽略。如果启用了虚拟线程（virtual threads），则此参数无效。 | |
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.simple.reject-tasks-when-limit-reached | 当达到并发限制时，是否拒绝任务。 | false |
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 |
spring.validation.method.adapt-constraint-violations | 是否将 ConstraintViolations 适配为 MethodValidationResult。 | false |
trace | 启用 trace 日志。 | false |
Data Migration Properties
数据属性
| 名称 | 描述 | 默认值 |
|---|---|---|
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 | 每个节点的最小 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 | 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.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 | 要连接的 bucket 名称。 | |
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.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 | Mongo 服务器主机。如果设置了 'uri'，则此选项被忽略。 | |
spring.data.mongodb.password | Mongo 服务器的登录密码。如果设置了 'uri'，则此字段会被忽略。 | |
spring.data.mongodb.port | Mongo 服务器端口。如果设置了 'uri'，则此选项被忽略。 | |
spring.data.mongodb.protocol | 用于 MongoDB 连接的协议。如果设置了 'uri'，则此选项会被忽略。 | mongodb |
spring.data.mongodb.replica-set-name | 集群所需的副本集名称。如果设置了 'uri'，则此选项将被忽略。 | |
spring.data.mongodb.repositories.type | 要启用的 Mongo 仓库类型。 | auto |
spring.data.mongodb.ssl.bundle | SSL bundle 名称。 | |
spring.data.mongodb.ssl.enabled | 是否启用 SSL 支持。如果提供了 "bundle"，则会自动启用，除非另有指定。 | |
spring.data.mongodb.uri | Mongo 数据库 URI。会覆盖 host、port、username 和 password。 | mongodb://localhost/test |
spring.data.mongodb.username | Mongo 服务器的登录用户。如果设置了 '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，在哨兵模式下连接池是隐式启用的，此设置仅适用于单节点配置。 | |
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 | 池中保持的最小空闲连接数的目标值。仅当该设置和驱逐运行间隔时间（time between eviction runs）均为正数时，此设置才会生效。 | 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 | 池中保持的最小空闲连接数的目标值。仅当该设置和驱逐运行间隔时间（time between eviction runs）均为正数时，此设置才会生效。 | 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.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 | 嵌入式数据库的连接详细信息。默认为 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-jndi | ||
| 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.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 JDBC DataSource 实例的 Tomcat 数据源特定设置 | |
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.connection-timeout | 与 Elasticsearch 通信时使用的连接超时时间。 | 1s |
spring.elasticsearch.password | 用于与 Elasticsearch 进行身份验证的密码。 | |
spring.elasticsearch.path-prefix | 添加到发送至 Elasticsearch 的每个请求路径前的前缀。 | |
spring.elasticsearch.restclient.sniffer.delay-after-failure | 失败后安排的 sniff 执行的延迟。 | 1m |
spring.elasticsearch.restclient.sniffer.interval | 连续普通 sniff 执行之间的间隔。 | 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 | 是否应跳过结果处理。当已知没有结果返回时，可用于优化 callable statement 的处理。 | 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 | 嵌入式 LDAP 用户名。 | |
spring.ldap.embedded.ldif | Schema (LDIF) 脚本资源引用。 | classpath:schema.ldif |
spring.ldap.embedded.port | 嵌入式 LDAP 端口。 | 0 |
spring.ldap.embedded.validation.enabled | 是否启用 LDAP schema 验证。 | true |
spring.ldap.embedded.validation.schema | 自定义 schema 的路径。 | |
spring.ldap.password | 服务器的登录密码。 | |
spring.ldap.referral | 指定服务提供者遇到的 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.neo4j.authentication.kerberos-ticket | 用于连接数据库的 Kerberos ticket。与给定的用户名互斥。 | |
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.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.* | Additional R2DBC options. | |
spring.r2dbc.url | 数据库的 R2DBC URL。URL 中指定的数据库名称、用户名、密码和连接池选项优先于单独的选项。 | |
spring.r2dbc.username | 数据库的登录用户名。如果 URL 中未指定用户名，则设置此项。 |
Devtools 属性
Docker Compose 属性
集成属性
JSON 属性
邮件属性
| 名称 | 描述 | 默认值 |
|---|---|---|
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。 注意，即使未设置 '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 属性
安全属性
Server Properties
| 名称 | 描述 | 默认值 |
|---|---|---|
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 channel 的连接超时。 | |
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"。 | |
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 上下文初始化参数。 | |
server.servlet.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 到 charset 的映射。 | |
server.servlet.jsp.class-name | 用于 JSP 的 servlet 的类名。如果 registered 为 true 且该类在 classpath 中，则会进行注册。 | 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"。 | |
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 标记为安全。 | |
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 bundle 的名称。 | |
server.ssl.certificate | 指向 PEM 编码的 SSL 证书文件的路径。 | |
server.ssl.certificate-private-key | SSL 证书的 PEM 编码私钥文件路径。 | |
server.ssl.ciphers | 支持的 SSL 加密套件。 | |
server.ssl.client-auth | 客户端认证模式。需要一个信任库（trust store）。 | |
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 | 密钥库的 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 | 信任库的 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 | 用于指定额外的 JAR 匹配模式列表，这些 JAR 将在 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 和流水线功能将被禁用。当设置为 -1 时，允许无限数量的流水线或 keep-alive 请求。 | 100 |
server.tomcat.max-parameter-count | 容器将自动解析的参数（GET 和 POST）的最大数量。小于 0 的值表示无限制。 | 10000 |
server.tomcat.max-part-count | multipart/form-data 请求中允许的最大部分总数。超过此限制的请求将被拒绝。小于 0 的值表示无限制。 | 50 |
server.tomcat.max-part-header-size | multipart/form-data 请求中每个部分的 header 允许的最大大小。超过此限制的请求将被拒绝。小于 0 的值表示无限制。 | 512B |
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 | 是否应通过在路径末尾附加 / 来重定向对上下文根的请求。当在代理处终止 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 header 名称。 | X-Forwarded-Port |
server.tomcat.remoteip.protocol-header | 包含传入协议的 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 | 静态资源缓存的 Time-to-live。 | 5s |
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。 | never |
server.tomcat.use-relative-redirects | 通过调用 sendRedirect 生成的 HTTP 1.1 及更高版本的 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 | 允许的最大 header 数量。此限制旨在防止基于哈希碰撞的 DOS 攻击。 | |
server.undertow.max-http-post-size | HTTP POST 内容的最大大小。 | 2MB |
server.undertow.max-parameters | 允许的最大查询参数或路径参数数量。此限制旨在防止基于哈希碰撞的 DOS 攻击。 | |
server.undertow.no-request-timeout | 连接在服务器关闭之前，可以空闲而不处理请求的最长时间。 | |
server.undertow.options.server.* | 在 io.undertow.UndertowOptions 中定义的服务器选项。 | |
server.undertow.options.socket.* | Socket 选项，定义于 org.xnio.Options 中。 | |
server.undertow.preserve-path-on-forward | 是否在转发请求时保留其路径。 | false |
server.undertow.threads.io | 为工作线程创建的 I/O 线程数量。默认值由可用处理器的数量决定。 | |
server.undertow.threads.worker | 工作线程的数量。默认值为 I/O 线程数量的 8 倍。 | |
server.undertow.url-charset | 用于解码 URL 的字符集。 | UTF-8 |
模板属性
Testcontainers 属性
| 名称 | 描述 | 默认值 |
|---|---|---|
spring.testcontainers.beans.startup | Testcontainers 启动模式。 | sequential |
spring.testcontainers.dynamic-property-registry-injection | 如何处理将 DynamicPropertyRegistry 注入到 @Bean 方法中的情况。 | fail |
测试属性
Transaction Properties
| 名称 | 描述 | 默认值 |
|---|---|---|
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 | 要允许的源模式列表。与仅支持 '*' 的 allowed origins 不同，origin patterns 更加灵活，例如 'https://*.example.com'，并且可以与 allow-credentials 一起使用。当 allowed origins 和 allowed origin patterns 均未设置时，跨域请求将被有效禁用。 | |
spring.graphql.cors.allowed-origins | 允许的源列表，其中 '*' 表示允许所有源。当启用了 allow-credentials 时，不能使用 '*'，此时应考虑设置源模式（origin patterns）。当既未设置允许的源，也未设置允许的源模式时，跨域请求将被有效禁用。 | |
spring.graphql.cors.exposed-headers | 响应中要包含的标头列表。 | |
spring.graphql.cors.max-age | 客户端可以缓存预检请求（pre-flight request）响应的时间长度。如果未指定时间单位后缀，则默认使用秒。 | 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.schema.additional-files | 要解析的额外独立 schema 文件的位置。 | [] |
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.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.client.connect-timeout | 客户端 HTTP 请求的默认连接超时时间。 | |
spring.http.client.factory | 用于客户端 HTTP 请求的默认工厂。 | |
spring.http.client.read-timeout | 客户端 HTTP 请求的默认读取超时时间。 | |
spring.http.client.redirects | 处理 HTTP 重定向。 | |
spring.http.client.ssl.bundle | 要使用的 SSL 证书包。 | |
spring.http.codecs.log-request-details | 是否在 DEBUG 级别记录表单数据，并在 TRACE 级别记录请求头。 | false |
spring.http.codecs.max-in-memory-size | 当输入流需要聚合时，可缓冲的字节数上限。这仅适用于自动配置的 WebFlux 服务器和 WebClient 实例。默认情况下未设置此值，此时将应用各个编解码器（codec）的默认限制。大多数编解码器默认限制为 256K。 | |
spring.http.converters.preferred-json-mapper | 用于 HTTP 消息转换的首选 JSON 映射器。默认情况下，会根据环境自动检测。支持的值为 'jackson'、'gson' 和 'jsonb'。当存在其他 JSON 映射库（例如 kotlinx.serialization）时，请使用自定义的 HttpMessageConverters Bean 来控制首选的映射器。 | jackson |
spring.http.reactiveclient.connect-timeout | 客户端 HTTP 请求的默认连接超时时间。 | |
spring.http.reactiveclient.connector | 客户端 HTTP 请求使用的默认连接器。 | |
spring.http.reactiveclient.read-timeout | 客户端 HTTP 请求的默认读取超时时间。 | |
spring.http.reactiveclient.redirects | 处理 HTTP 重定向。 | |
spring.http.reactiveclient.ssl.bundle | 要使用的 SSL 证书包。 | |
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.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 | 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 | 是否启用对分段上传的支持。 | 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 | 会话的刷新模式。决定何时将对会话的更改写入会话存储。 | on-save |
spring.session.hazelcast.map-name | 用于存储会话的 map 的名称。 | spring:session:sessions |
spring.session.hazelcast.save-mode | 会话保存模式。决定如何跟踪会话更改并将其保存到会话存储中。 | on-set-attribute |
spring.session.jdbc.cleanup-cron | 用于过期会话清理任务的 Cron 表达式。 | 0 * * * * * |
spring.session.jdbc.flush-mode | 会话的刷新模式。决定何时将会话的更改写入会话存储。 | 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 文件路径。 | classpath:org/springframework/session/jdbc/schema-@@platform@@.sql |
spring.session.jdbc.table-name | 用于存储会话的数据库表的名称。 | SPRING_SESSION |
spring.session.mongodb.collection-name | 用于存储会话的集合名称。 | sessions |
spring.session.redis.cleanup-cron | 用于过期会话清理任务的 Cron 表达式。仅在 repository-type 设置为 indexed 时支持。不支持响应式会话仓库（reactive session repository）。 | 0 * * * * * |
spring.session.redis.configure-action | 当不存在用户定义的 ConfigureRedisAction 或 ConfigureReactiveRedisAction bean 时，要应用的 configure 操作。 | notify-keyspace-events |
spring.session.redis.flush-mode | Session 的刷新模式。决定何时将 session 的更改写入 session 存储。不支持与响应式 session 仓库（reactive session repository）一起使用。 | on-save |
spring.session.redis.namespace | 用于存储会话的键的命名空间。 | spring:session |
spring.session.redis.repository-type | 要配置的 Redis 会话仓库类型。 | default |
spring.session.redis.save-mode | 会话保存模式。决定如何跟踪会话更改并将其保存到会话存储中。 | on-set-attribute |
spring.session.servlet.filter-dispatcher-types | Session repository filter 的 dispatcher 类型。 | [async, error, request] |
spring.session.servlet.filter-order | Session repository filter 的顺序。 | |
spring.session.timeout | 会话超时。如果未指定时间单位后缀，则默认使用秒。 | |
spring.web.locale | 要使用的 Locale。默认情况下，此 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.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 | 每个 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/** |