SpringBoot application.properties 的详细配置说明。

这些属性是否生效取决于对应的组件是否声明为 Spring 应用程序上下文里的 Bean（基本是自动配置的），为一个不生效的组件设置属性是没有用的。

multipart

multipart.enabled 开启上传支持（默认：true）

multipart.file-size-threshold: 大于该值的文件会被写到磁盘上

multipart.location 上传文件存放位置

multipart.max-file-size最大文件大小

multipart.max-request-size 最大请求大小

server

server.address 服务器地址

server.port服务器端口

server.context-parameters.[param name]设置 servlet 上下文参数

server.context-path应用上下文路径

Jsp-servelt

server.jsp-servelt.class-name针对 jsp 使用的 Servlet 类名（默认：org.apache.jasper.servlet.JspServlet）

server.jsp-servlet.registered JspServelt 是否要注册到内嵌的 Servlet 容器里（默认 true）

server.jsp-servlet.init-parameters[param name] 设置 Jsp Servlet 初始化参数

server.servlet-path主分发器 Servlet 的路径（默认：/）

Session

server.session.cookie.domain 回话 Cookie 的域

server.session.cookie.comment Cookie 注释

server.session.cookie.max-age Cookie 最大保存时间（单位 s）

server.session.cookie.name Cookie 名称

server.session.cookie.timeout 超时时间

tomcat

server.tomcat.accesslog.directory 创建日志文件的目录

server.tomcat.accesslog.enabled 是否开启访问日志（默认：false）

server.tomcat.accesslog.pattern 访问日志的格式（默认：common）

server.tomcat.accesslog.prefix日志名前缀（默认：access_log）

server.tomcat.accesslog.suffix 日志名后缀（默认：.log）

server.tomcat.max-http-header-sizeHttp 消息头最大字节数（默认：0）

server.tomcat.uri-encoding 用来解码 URI 的字符编码

Cache

spring.cache.cache-names 如果底层缓存管理器支持缓存名的话，可以在这里指定要创建的缓存名列表，用逗号分 隔。通常这会禁用运行时创建其他额外缓存的能力。

spring.cache.config 用来初始化 EhCache 的配置文件位置

spring.cache.guava.spec 用来创建缓存 Spec

spring.cache.hazelcast.config 用来初始化 Hazeleast 的配置文件位置

spring.cache.infinispan.config 用来初始化 Infinispan 配置文件位置

spring.cache.jcache.config用来初始化缓存管理器的配置文件的位置，配置文件依赖于底层的缓存实现

spring.cache.jcache.provider CachingProvider 实现的全限定类名，用来获取 JSR-107 兼容的缓存管理器，仅在 Classpath 里有不只一个 JSR-107 实现时才需要这个属性。

spring.cache.type 缓存类型，默认根据环境自动检测

Data

spring.data.jpa.repositories.enabled 开启 JPA 仓库（默认：true）

spring.data.mongodb.authentication-database 身份认证数据库名

spring.data.mongodb.database 数据库名

spring.data.mongodb.field-naming-strategy 要使用的 FieldNamingStrategy 的全限定名。

spring.data.mongodb.grid.fs.database GridFS 数据库名称

spring.data.mongodb.host MongoDB 服务器地址

spring.data.mongodb.username MongoDB 账号

spring.data.mongodb.passwordMongoDB 密码

spring.data.mongodb.port 端口号

spring.data.mongodb.repositories.enabled 开启 Mongo 仓库（默认值：true）

spring.data.mongodb.uri Mongo 数据库 URI。设置了该属性后就主机和端口号会被忽略。（默认值： mongodb:// localhost/test）

spring.data.rest.base-path 用于发布仓库资源的基本路径

spring.data.rest.default-page-size 分页数据的默认页大小（默认：20）

spring.data.rest.limit-param-name用于标识一次返回多少记录的 URL 查询字符串参数名。（默认值： size ）

spring.data.rest.max-page-sieze: 最大分页大小（默认：1000）

spring.data.rest.page-param-name URL 查询字符串参数的名称，用来标识返回哪一页。（默认值： page ）

spring.data.rest.return-body-on-create 在创建实体后是否返回一个响应体（默认：false）

spring.data.rest.return-body-on-update 在更新实体后是否返回一个响应体（默认：false）

spring.data.rest.sort-param-name URL 查询字符串参数的名称，用来表示结果排序的方向（默认：name）

spring.data.solr.host Solr 的主机地址。如果设置了 zk-host 则忽略该属性。（默认值： http://127.0.0.1: 8983/solr ）

spring.data.solr.repositories.enabled 开启 solr 仓库（默认：true）

spring.data.solr.zk-host zk 主机地址，格式为 "主机 - 端口"

spring.datasource.allow-pool-suspension 是否允许池暂停（pool suspension）。在开启池暂停后会有性能会受到一定影响，除非你 真的需要这个功能（例如在冗余的系统下），否则不要开启它。该属性只在使用 Hikari 数 据库连接池时有用。（默认值： false 。）

DataSource

spring.datasource.name 数据源的名称。

spring.datasource.username 数据库的登录用户名。

spring.datasource.password 数据库的登录密码。

spring.datasource.url 数据库的 JDBC URL。

spring.datasource.jdbc-url 用来创建连接的 JDBC URL。

spring.datasource.driver-class-name JDBC 驱动的全限定类名。默认根据 URL 自动检测。

spring.datasource.pool-name 连接池名称。

spring.datasource.max-active 连接池中的最大活跃连接数。

spring.datasource.connection-timeout连接超时（单位毫秒）

spring.datasource.max-age 连接池中连接的最长寿命。

spring.datasource.max-idle 连接池中的最大空闲连接数。

spring.datasource.max-lifetime 连接池中连接的最长寿命（单位为毫秒）。

spring.datasource.max-open-prepared-statements 开启状态的 PreparedStatement 的数量上限。

spring.datasource.max-wait 连接池在等待返回连接时，最长等待多少毫秒再抛出异常。

spring.datasource.maximum-pool-size 连接池能达到的最大规模，包含空闲连接的数量和使用中的连接数量。

spring.datasource.min-evictable-idle-time-millis 一个空闲连接被空闲连接释放器（如果存在的话）优雅地释放前，最短会在连接池里停 留多少时间。

spring.datasource.min-idle 连接池里始终应该保持的最小连接数。（用于 DBCP 和 Tomcat 连接池。）

spring.datasource.minimum-idle: HikariCP 试图在连接池里维持的最小空闲连接数。

spring.datasource.alternate-username-allowed 是否允许其它用户名

spring.datasource.auto-commit 更新操作是否自动提交

spring.datasource.abandon-when-percentage-full 一个百分比形势的阈值，超过该阈值则关闭并报告被弃用的连接

spring.datasource.catalog 默认的 Catalog 名称

spring.datasource.commit-on-return 在连接归还时，连接池是否要提交挂起的事务

spring.datasource.connection-init-sql 在所有新连接创建时都会执行的 SQL 语句，该语句会在连接加入连接池前执行。

spring.datasource.connection-init-sqls 在物理连接第一次创建时执行的 SQL 语句列表。（用于 DBCP 连接池。）

spring.datasource.connection-properties.[key] 设置创建连接时使用的属性。（用于 DBCP 连接池。）

spring.datasource.continue-on-error 初始化数据库时发生错误不要终止。（默认值： false）

spring.datasource.data 指向数据（数据库操纵语言，Data Manipulation Language，DML）脚本资源的引用。

spring.datasource.data-source-class-name 用于获取连接的数据源的全限定类名。

spring.datasource.data-source-jndi 用于获取连接的数据源的 JNDI 位置。

spring.datasource.data-source-properties.[key] 设置创建数据源时使用的属性。（用于 Hikari 连接池。）

spring.datasource.db-properties 设置创建数据源时使用的属性。（用于 Tomcat 连接池。）

spring.datasource.default-auto-commit 连接上的操作是否自动提交。

spring.datasource.default-catalog 连接的默认 Catalog。

spring.datasource.default-read-only 连接的默认只读状态。

spring.datasource.default-transaction-isolation 连接的默认事务隔离级别。

spring.datasource.fair-queue 是否以 FIFO 方式返回连接。

spring.datasource.health-check-properties.[key] 设置要纳入健康检查的属性。（用于 Hikari 连接池。）

spring.datasource.idle-timeout 连接池中的连接能保持闲置状态的最长时间，单位为毫秒。（默认值： 10 。）

spring.datasource.ignore-exception-on-pre-load 初始化数据库连接池时是否要忽略连接。

spring.datasource.init-sql在连接第一次创建时运行的自定义查询。

spring.datasource.initial-size 在连接池启动时要建立的连接数。

spring.datasource.initialization-fail-fast 在连接池创建时，如果达不到最小连接数是否要抛出异常。（默认值： true 。）

spring.datasource.initialize 使用 data.sql 初始化数据库。（默认值： true 。）

spring.datasource.isolate-internal-queries 是否要隔离内部请求。（默认值： false 。）

spring.datasource.jdbc-interceptors 一个分号分隔的类名列表，这些类都扩展了 JdbcInterceptor 类。这些拦截器会插入 java.sql.Connection 对象的操作链里。（用于 Tomcat 连接池。）

spring.datasource.jmx-enabled 开启 JMX 支持（如果底层连接池提供该功能的话）。（默认值： false 。）

spring.datasource.jndi-name 数据源的 JNDI 位置。设置了该属性则忽略类、URL、用户名和密码属性。

spring.datasource.leak-detection-threshold 用来检测 Hikari 连接池连接泄露的阈值，单位为毫秒。

spring.datasource.log-abandoned 是否针对弃用语句或连接的应用程序代码记录下跟踪栈。用于 DBCP 连接池。（默认值： false 。）

spring.datasource.log-validation-errors 在使用 Tomcat 连接池时是否要记录验证错误。

spring.datasource.login-timeout 连接数据库的超时时间（单位为秒）。

spring.datasource.num-tests-per-eviction-run 空闲对象释放器线程（如果存在的话）每次运行时要检查的对象数。

spring.datasource.platform 在 Schema 资源（schema-${platform}.sql）里要使用的平台。（默认值： all 。）

spring.datasource.pool-prepared-statements 是否要将 Statement 放在池里。

spring.datasource.propagate-interrupt-state 对于等待连接的中断线程，是否要传播中断状态。

spring.datasource.read-only 在使用 Hikari 连接池时将数据源设置为只读。

spring.datasource.register-mbeans Hikari 连接池是否要注册 JMX MBean。

spring.datasource.remove-abandoned 被弃用的连接在到达弃用超时后是否应该被移除。

spring.datasource.remove-abandoned-timeout 连接在多少秒后应该考虑弃用。

spring.datasource.rollback-on-return 在连接归还连接池时，是否要回滚挂起的事务。

spring.datasource.schema Schema（数据定义语言，Data Definition Language，DDL）脚本资源的引用。

spring.datasource.separator SQL 初始化脚本里的语句分割符。（默认值： ; 。）

spring.datasource.sql-script-encoding SQL 脚本的编码。

spring.datasource.suspect-timeout 在记录一个疑似弃用连接前要等待多少秒。

spring.datasource.test-on-borrow 从连接池中借用连接时是否要进行测试。

spring.datasource.test-on-connect 在建立连接时是否要进行测试。

spring.datasource.test-on-return 在将连接归还到连接池时是否要进行测试。

spring.datasource.test-while-idle 在连接空闲时是否要进行测试。

spring.datasource.time-between-eviction-runs-millis 在两次空闲连接验证、弃用连接清理和空闲池大小调整之间睡眠的毫秒数。

spring.datasource.transaction-isolation 在使用 Hikari 连接池时设置默认事务隔离级别。

spring.datasource.use-disposable-connection-facade 连接是否要用一个门面（facade）封装起来，在调用了 Connection.close() 后就不能 再使用这个连接了。

spring.datasource.use-equals 在比较方法名时是否使用 String.equals() 来代替 == 。

spring.datasource.use-lock 在操作连接对象时是否要加锁。

spring.datasource.validation-interval 执行连接验证的间隔时间，单位为毫秒。

spring.datasource.validation-query 在连接池里的连接返回给调用者或连接池时，要执行的验证 SQL 查询。

spring.datasource.validation-query-timeout 在连接验证查询执行失败前等待的超时时间，单位为秒。

spring.datasource.validation-timeout 在连接验证失败前等待的超时时间，单位为秒。（用于 Hikari 连接池。）

spring.datasource.validator-class-name 可选验证器类的全限定类名，用于执行测试查询。

spring.datasource.xa.data-source-class-name XA 数据源的全限定类名。

spring.datasource.xa.properties 要传递给 XA 数据源的属性。

FreeMarker

spring.freemarker.allow-request-override HttpServletRequest 的属性是否允许覆盖（隐藏）控制器生成的同名模型属性。

spring.freemarker.allow-session-override HttpSession 的属性是否允许覆盖（隐藏）控制器生成的同名模型属性。

spring.freemarker.cache 开启模板缓存。

spring.freemarker.charset 模板编码。

spring.freemarker.check-template-location 检查模板位置是否存在。

spring.freemarker.content-type Content-Type 的值。

spring.freemarker.enabled 开启 FreeMarker 的 MVC 视图解析。

spring.freemarker.expose-request-attributes 在模型合并到模板前，是否要把所有的请求属性添加到模型里。

spring.freemarker.expose-session-attributes 在模型合并到模板前，是否要把所有的 HttpSession 属性添加到模型里。

spring.freemarker.expose-spring-macro-helpers 是否发布供 Spring 宏程序库使用的 RequestContext ，并将命其名为 springMacro- RequestContext

spring.freemarker.prefer-file-system-access 加载模板时优先通过文件系统访问。文件系统访问能够实时检测到模板变更。（默认值： true 。）

spring.freemarker.prefix 在构建 URL 时添加到视图名称前的前缀。

spring.freemarker.request-context-attribute 在所有视图里使用的 RequestContext 属性的名称。

spring.freemarker.settings 要传递给 FreeMarker 配置的各种键。

spring.freemarker.suffix 在构建 URL 时添加到视图名称后的后缀。

spring.freemarker.template-loader-path 模板路径列表，用逗号分隔。（默认值： ["classpath:/templates/"] 。）

spring.freemarker.view-names 可解析的视图名称的白名单。

Groovy

spring.groovy.template.allow-request-override HttpServletRequest 的属性是否允许覆盖（隐藏）控制器生成的同名模型属性。

spring.groovy.template.allow-session-override HttpSession 的属性是否允许覆盖（隐藏）控制器生成的同名模型属性。

spring.groovy.template.cache 开启模板缓存。

spring.groovy.template.charset 模板编码。

spring.groovy.template.check-template-location 检查模板位置是否存在。

spring.groovy.template.configuration.auto-escape 模型变量在模板里呈现时是否要做转义。（默认值： false 。）

spring.groovy.template.configuration.auto-indent 模板是否要自动呈现缩进。（默认值： false 。）

spring.groovy.template.configuration.auto-indent-string 开启自动缩进时用于缩进的字符串，可以是 SPACES ，也可以是 TAB 。（默认值： SPACES 。）

spring.groovy.template.configuration.auto-new-line 模板里是否要呈现新的空行。（默认值： false 。）

spring.groovy.template.configuration.base-template-class 模板基类。

spring.groovy.template.configuration.cache-templates 模板是否应该缓存。（默认值： true 。）

spring.groovy.template.configuration.declaration-encoding 用来写声明头的编码。

spring.groovy.template.configuration.expand-empty-elements 没有正文的元素该用短形式（例如， ）还是扩展形式（例如， ）来书 写。（默认值： false）

spring.groovy.template.configuration.locale 设置模板地域。

spring.groovy.template.configuration.new-line-string 在自动空行开启后用来呈现空行的字符串。（默认为系统的 line.separator 属性值。）

spring.groovy.template.configuration.resource-loader-path Groovy 模板的路径。（默认值： classpath:/templates/ 。）

spring.groovy.template.configuration.use-double-quotes 属性是该用双引号还是单引号。（默认值： false 。）

spring.groovy.template.content-type Content-Type 的值。

spring.groovy.template.enabled 开启 Groovy 模板的 MVC 视图解析。

spring.groovy.template.expose-request-attributes 在模型合并到模板前，是否要把所有的请求属性添加到模型里。

spring.groovy.template.expose-session-attributes 在模型合并到模板前，是否要把所有的 HttpSession 属性添加到模型里。

spring.groovy.template.expose-spring-macro-helpers 是否发布供 Spring 宏程序库使用的 RequestContext ，并将其命名为 springMacro- RequestContext

spring.groovy.template.prefix 在构建 URL 时，添加到视图名称前的前缀。

spring.groovy.template.request-context-attribute 所有视图里使用的 RequestContext 属性的名称。

spring.groovy.template.resource-loader-path 模板路径（默认值： classpath:/ templates/ 。）

spring.groovy.template.suffix 在构建 URL 时，添加到视图名称后的后缀。

spring.groovy.template.view-names 可解析的视图名称白名单。

H2

spring.h2.console.enabled 开启控制台。（默认值： false 。）

spring.h2.console.path 可以找到控制台的路径。（默认值： /h2-console 。）

Hornetq

spring.hornetq.embedded.cluster-password 集群密码。默认在启动时随机生成。

spring.hornetq.embedded.data-directory 日志文件目录。如果关闭了持久化功能则不需要该属性。

spring.hornetq.embedded.enabled 如果有 HornetQ 服务器 API，则开启嵌入模式。（默认值： true 。）

spring.hornetq.embedded.persistent 开启持久化存储。（默认值： false 。）

spring.hornetq.embedded.queues 启动时要创建的队列列表，用逗号分隔。（默认值： [] 。）

spring.hornetq.embedded.server-id 服务器 ID。默认使用自增长计数器。（默认值： 0 。）

spring.hornetq.embedded.topics 启动时要创建的主题列表，用逗号分隔。（默认值： [] 。）

spring.hornetq.host HornetQ 的主机。（默认值： localhost 。）

spring.hornetq.mode HornetQ 的部署模式，默认为自动检测。可以显式地设置为 native 或 embedded 。

spring.hornetq.port HornetQ 的端口。（默认值： 5445 。）

Http

spring.http.converters.preferred-json-mapper HTTP 消息转换时优先使用 JSON 映射器。

spring.http.encoding.charset HTTP 请求和响应的字符集。如果没有显式地指定 Content-Type 头，则将该属性值作为 这个头的值。（默认值： UTF-8 。）

spring.http.encoding.enabled 开启 HTTP 编码支持。（默认值： true 。）

spring.http.encoding.force 强制将 HTTP 请求和响应编码为所配置的字符集。（默认值： true 。）

Jackson

spring.jackson.date-format 日期格式字符串（yyyy-MM-dd HH