1.概述
Spring Boot Web应用程序默认包含预配置的嵌入式Web服务器。但在某些情况下,我们要修改默认配置以满足自定义要求。
在本教程中,我们将介绍通过application.properties文件配置Tomcat嵌入式服务器的一些常见用例。
2.常见的嵌入式Tomcat配置
2.1. 服务器地址和端口
我们希望更改的最常见配置是端口号:
-
server.port = 80
在某些情况下,我们可能希望设置服务器应绑定的网络地址。换句话说,我们定义一个服务器将监听的IP地址:
-
server.address = my_custom_ip
2.2. 错误处理
默认情况下,Spring Boot提供标准错误网页。此页面称为Whitelabel。它默认启用,但如果我们不想显示任何错误信息,我们可以禁用它:
-
server.error.whitelabel.enabled = false
-
Whitelabel
的默认路径是/error。可以通过设置server.error.path参数来自定义它:
-
server.error.path = /user-error
还可以设置属性,以确定显示有关错误的信息。例如,我们可以包含错误消息和堆栈跟踪:
-
server.error.include-exception= true
-
server.error.include-stacktrace= always
我们的教程Exception Message Handling for REST和Customize Whitelabel Error Page详细解释有关Spring Boot中处理错误的更多信息。
2.3. 服务器连接
当在低资源容器上运行时,我们可能希望减少CPU和内存负载。一种方法是限制应用程序可以同时处理的请求数量。相反,我们可以增加此值以使用更多可用资源来获得更好的性能。
SpringBoot
Tomcat
工作线程的最大数量:
-
server.tomcat.max-threads= 200
配置Web服务器时,设置服务器连接超时也可能很有用。这表示服务器在连接关闭之前等待客户端发出请求的最长时间:
-
server.connection-timeout= 5s
我们还可以定义请求头的最大大小:
-
server.max-http-header-size= 8KB
请求正文的最大大小:
-
server.tomcat.max-swallow-size= 2MB
或者整个POST请求的最大大小:
-
server.tomcat.max-http-post-size= 2MB
2.4. SSL
要在我们的Spring Boot应用程序中启用SSL支持,我们需要将server.ssl.enabled属性设置为true,并定义SSL协议:
-
server.ssl.enabled = true
-
server.ssl.protocol = TLS
我们要配置保存证书密钥库的密码,类型和路径:
-
server.ssl.key-store-password=my_password
-
server.ssl.key-store-type=keystore_type
-
server.ssl.key-store=keystore-path
我们还必须定义标识密钥库中密钥的别名:
-
server.ssl.key-alias=tomcat
有关SSL配置的更多信息,请访问:HTTPS using self-signed certificate in Spring Boot。
2.5. Tomcat服务器访问日志
在尝试统计页面命中数,用户会话活动等时,Tomcat访问日志非常有用。
要启用访问日志,只需设置:
-
server.tomcat.accesslog.enabled = true
我们还应该配置其他参数,例如附加到日志文件的目录名,前缀,后缀和日期格式:
-
server.tomcat.accesslog.directory=logs
-
server.tomcat.accesslog.file-date-format=yyyy-MM-dd
-
server.tomcat.accesslog.prefix=access_log
-
server.tomcat.accesslog.suffix=.log