SpringBoot所有配置项的中文说明（使用Deepl翻译），由 SpringBoot中文社区 整理提供。

目录

• 1. Core properties
• 2. Cache properties
• 3. Mail properties
• 4. JSON properties
• 5. Data properties
• 6. Transaction properties
• 7. Data migration properties
• 8. Integration properties
• 9. Web properties
• 10. Templating properties
• 11. Server properties
• 12. Security properties
• 13. RSocket properties
• 14. Actuator properties
• 15. Devtools properties
• 16. Testing properties

1. Core properties

配置项

默认值

说明

debug

false

启用调试日志。

info.*

要添加到info端点的任意属性。

logging.config

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

logging.exception-conversion-word

%wEx

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

logging.file.clean-history-on-start

false

是否在启动时清理存档日志文件。仅支持默认的logback设置。

logging.file.max-history

7.0

存档日志文件的最大保存天数。仅支持默认的logback设置。

logging.file.max-size

10MB

最大日志文件大小。仅支持默认的logback设置。

logging.file.name

日志文件名（例如，myapp.log）。名称可以是确切的位置，也可以是当前目录的相对位置。

logging.file.path

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

logging.file.total-size-cap

0B

要保存的日志备份的总大小。仅支持默认的logback设置。

logging.group.*

日志组可以同时快速更换多个记录器。例如，logging.group.db=org.hibernate,org.springframework.jdbc。

logging.level.*

日志等级严重性映射。例如，logging.level.org.springframework=DEBUG。

logging.pattern.console

%clr(%d{${LOG_DATEFORMAT_PATTERN:-yyyy-MM-dd HH:mm:ss.SSS}}){faint} %clr(${LOG_LEVEL_PATTERN:-%5p}) %clr(${PID:- }){magenta} %clr(---){faint} %clr([%15.15t]){faint} %clr(%-40.40logger{39}){cyan} %clr(:){faint} %m%n${LOG_EXCEPTION_CONVERSION_WORD:-%wEx}

输出到控制台的日志格式。仅支持默认的logback设置。

logging.pattern.dateformat

yyyy-MM-dd HH:mm:ss.SSS

日志中日期的格式化。仅支持默认的logback设置。

logging.pattern.file

%d{${LOG_DATEFORMAT_PATTERN:-yyyy-MM-dd HH:mm:ss.SSS}} ${LOG_LEVEL_PATTERN:-%5p} ${PID:- } --- [%t] %-40.40logger{39} : %m%n${LOG_EXCEPTION_CONVERSION_WORD:-%wEx}

输出到文件的日志格式。仅支持默认的logback设置。

logging.pattern.level

%5p

日志级别的应用者模式。仅支持默认的logback设置。

logging.pattern.rolling-file-name

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

滚动日志文件名的模式。仅支持默认的logback设置。

logging.register-shutdown-hook

false

在初始化日志系统时，为其注册一个关闭钩子。

spring.aop.auto

true

添加@EnableAspectJAutoProxy。

spring.aop.proxy-target-class

true

是否要创建基于子类的（CGLIB）代理（true），而不是基于标准Java接口的代理（false）。

spring.application.admin.enabled

false

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

spring.application.admin.jmx-name

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

应用管理MBean的JMX名称。

spring.application.name

应用名称。

spring.autoconfigure.exclude

要排除的自动配置类。

spring.banner.charset

UTF-8

Banner文件编码。

spring.banner.image.bitdepth

4.0

用于ANSI颜色的位深度。支持的值是4（16色）或8（256色）。

spring.banner.image.height

横幅图像的高度，单位为chars（默认基于图像高度）。

spring.banner.image.invert

false

暗终端主题的图片是否应该倒置。

spring.banner.image.location

classpath:banner.gif

横幅图片文件位置（也可使用jpg或png）。

spring.banner.image.margin

2.0

左手图像边距，单位为字符。

spring.banner.image.pixelmode

TEXT

渲染图像时要使用的像素模式。

spring.banner.image.width

76.0

横幅图像的宽度，单位为chars。

spring.banner.location

classpath:banner.txt

横幅文字资源位置。

spring.beaninfo.ignore

true

是否跳过对BeanInfo类的搜索。

spring.codec.log-request-details

false

否在DEBUG级别记录表格数据，在TRACE级别记录标题。

spring.codec.max-in-memory-size

每当需要聚合输入流时，可以缓冲的字节数的限制。这仅适用于自动配置的WebFlux服务器和WebClient实例。默认情况下，该选项未被设置，在这种情况下，适用于各个编解码器的默认值。大多数编解码器默认限制为256K。

spring.config.additional-location

除默认值外，还使用的配置文件位置。

spring.config.location

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

spring.config.name

application

配置文件名。

spring.info.build.encoding

UTF-8

文件编码。

spring.info.build.location

classpath:META-INF/build-info.properties

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

spring.info.git.encoding

UTF-8

文件编码。

spring.info.git.location

classpath:git.properties

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

spring.jmx.default-domain

JMX域名。

spring.jmx.enabled

false

将管理Bean暴露给JMX域。

spring.jmx.server

mbeanServer

MBeanServer bean名称。

spring.jmx.unique-names

false

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

spring.lifecycle.timeout-per-shutdown-phase

30s

任何阶段（具有相同 "阶段 "值的SmartLifecycle beans组）的关闭超时。

spring.main.allow-bean-definition-overriding

false

是否允许bean定义覆盖，通过注册一个与现有定义同名的定义。

spring.main.banner-mode

console

应用程序运行时用于显示横幅的模式。

spring.main.cloud-platform

覆盖云平台自动检测。

spring.main.lazy-initialization

false

是否应该懒惰地进行初始化。

spring.main.log-startup-info

true

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

spring.main.register-shutdown-hook

true

应用程序是否应该注册一个关机钩。

spring.main.sources

要包含在ApplicationContext中的源（类名、包名或XML资源位置）。

spring.main.web-application-type

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

spring.mandatory-file-encoding

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

spring.messages.always-use-message-format

false

是否总是应用MessageFormat规则，甚至解析没有参数的消息。

spring.messages.basename

messages

以逗号分隔的基名列表（本质上是一个完全限定的classpath位置），每个基名都遵循ResourceBundle惯例，但对基于斜杠的位置的支持有所放松。如果它不包含包限定符（如 "org.mypackage"），将从classpath根目录解析。

spring.messages.cache-duration

加载的资源捆绑文件缓存时间。未设置时，捆绑文件将被永远缓存。如果没有指定持续时间的后缀，将使用秒。

spring.messages.encoding

UTF-8

信息捆绑编码。

spring.messages.fallback-to-system-locale

true

如果关闭了这个功能，唯一的回退将是默认文件(例如 "messages "基名的 "messages.properties")。

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

false

是否使用消息代码作为默认消息，而不是抛出 "NoSuchMessageException"。仅在开发过程中推荐使用。

spring.output.ansi.enabled

detect

配置ANSI输出。

spring.pid.fail-on-write-error

如果使用ApplicationPidFileWriter但不能写入PID文件，则失败。

spring.pid.file

要写入的PID文件的位置（如果使用ApplicationPidFileWriter）。

spring.profiles

以逗号分隔的配置文件表达式列表，至少有一个应与之匹配，才能将文件包含在内。

spring.profiles.active

逗号分隔的活动配置文件列表。可由命令行开关覆盖。

spring.profiles.include

无条件激活指定的以逗号分隔的配置文件列表（如果使用YAML，则激活配置文件列表）。

spring.quartz.auto-startup

true

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

spring.quartz.jdbc.comment-prefix

[#, --]

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

spring.quartz.jdbc.initialize-schema

embedded

数据库模式初始化模式。

spring.quartz.jdbc.schema

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

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

spring.quartz.job-store-type

memory

石英工作店型。

spring.quartz.overwrite-existing-jobs

false

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

spring.quartz.properties.*

额外的Quartz Scheduler属性。

spring.quartz.scheduler-name

quartzScheduler

调度器的名称。

spring.quartz.startup-delay

0s

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

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

false

是否在关机时等待运行的工作完成。

spring.reactor.debug-agent.enabled

true

反应堆调试代理是否应该在反应堆工具存在时启用。

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

true

是否允许核心线程超时。这样可以实现池的动态增长和收缩。

spring.task.execution.pool.core-size

8.0

核心线程数。

spring.task.execution.pool.keep-alive

60s

线程在被终止前可以保持空闲的时间限制。

spring.task.execution.pool.max-size

允许的最大线程数。如果任务占满了队列，池可以扩展到该大小以适应负载。如果队列是无约束的，则忽略。

spring.task.execution.pool.queue-capacity

队列容量。无限制的容量不会增加队列池，因此忽略了 "最大容量 "属性。

spring.task.execution.shutdown.await-termination

false

执行者是否应该在关机时等待预定任务完成。

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

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

spring.task.execution.thread-name-prefix

task-

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

spring.task.scheduling.pool.size

1.0

允许的最大线程数。

spring.task.scheduling.shutdown.await-termination

false

执行者是否应该在关机时等待预定任务完成。

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

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

spring.task.scheduling.thread-name-prefix

scheduling-

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

trace

false

启用跟踪日志。

查看所有的配置

篇幅有限，配置项实在太多。查看所有的配置可以戳。 https://prop.springboot.io/