Spring Boot 内嵌服务器

Spring Boot 内嵌服务器全面解析

Spring Boot 是目前最流行的 Java 后端框架之一，其内嵌服务器特性使得开发者无需单独部署应用服务器，大大简化了项目的开发和部署流程。在 Spring Boot 中，应用程序自带一个内嵌的 Web 服务器，如 Tomcat、Jetty 或 Undertow，这为开发和运行微服务提供了极大的便利。

一、什么是 Spring Boot 内嵌服务器？

Spring Boot 的内嵌服务器（Embedded Server）是一种将 Web 服务器直接打包到应用中的技术。与传统 Java Web 应用不同，Spring Boot 应用不需要在外部应用服务器（如 Apache Tomcat 或 JBoss）中部署，而是通过一个独立的可运行 JAR 文件启动自己的内嵌服务器。

特点：

二、Spring Boot 内嵌服务器的默认行为

Spring Boot 默认使用 Tomcat 作为内嵌服务器，并在启动时自动加载相关配置。以下是一个简单的 Spring Boot 应用程序示例：

示例：默认内嵌服务器启动

@SpringBootApplication
public class EmbeddedServerDemoApplication {
public static void main(String[] args) {
SpringApplication.run(EmbeddedServerDemoApplication.class, args);
}
}

运行上述程序后，控制台会显示如下输出，表示 Tomcat 内嵌服务器已启动：

Tomcat started on port(s): 8080 (http) with context path ''

三、更换内嵌服务器

Spring Boot 默认使用 Tomcat，但也支持 Jetty 和 Undertow。可以通过替换依赖轻松更改内嵌服务器。

3.1 使用 Jetty

步骤：

运行应用后，控制台输出将显示 Jetty 已启动：

Jetty started on port(s): 8080 (http) with context path ''

3.2 使用 Undertow

步骤：

运行后，控制台会显示 Undertow 启动日志。

四、内嵌服务器的常见配置

Spring Boot 提供了多种方式来配置内嵌服务器，包括 application.properties 文件和 Java 代码。

4.1 配置端口

默认情况下，Spring Boot 的内嵌服务器运行在 8080 端口。可以通过以下方式修改端口：

方法 1：在 application.properties 中配置

server.port=9090

方法 2：使用 Java 代码配置

@Bean
public WebServerFactoryCustomizer<ConfigurableWebServerFactory> webServerFactoryCustomizer() {
return factory -> factory.setPort(9090);
}

4.2 配置上下文路径

上下文路径是服务器中应用程序的访问路径。默认情况下，Spring Boot 使用根路径 "/"。

修改上下文路径

server.servlet.context-path=/myapp

启动后，应用将通过 http://localhost:8080/myapp 访问。

4.3 配置最大线程数

可以通过以下方式调整服务器线程池的最大线程数，以提升并发处理能力：

server.tomcat.threads.max=200

或使用 Java 配置：

@Bean
public WebServerFactoryCustomizer<TomcatServletWebServerFactory> customizer() {
return factory -> factory.addConnectorCustomizers(connector -> {
connector.setAttribute("maxThreads", 200);
});
}

4.4 配置 SSL

为内嵌服务器启用 HTTPS，可以通过以下步骤完成：

五、禁用内嵌服务器

在某些场景中（如仅开发 REST 客户端应用），可以禁用内嵌服务器。

方法：将 web 环境设置为 NONE

@SpringBootApplication
public class NonWebApplication {
public static void main(String[] args) {
SpringApplication app = new SpringApplication(NonWebApplication.class);
app.setWebApplicationType(WebApplicationType.NONE);
app.run(args);
}
}

六、常见问题和解决方案

6.1 端口冲突

问题： 内嵌服务器启动时，端口被其他进程占用。

解决方案：

6.2 启动时间过长

问题： 内嵌服务器启动时间过长可能与线程池或配置错误有关。

解决方案：

6.3 内嵌服务器日志过多

问题： 控制台输出大量内嵌服务器的启动日志。

解决方案： 调整日志级别：

logging.level.org.apache.catalina=INFO
logging.level.org.eclipse.jetty=INFO
logging.level.io.undertow=INFO

七、实践案例：构建一个简单的 Web 服务

完整示例：用户管理服务

@RestController
@RequestMapping("/users")
public class UserController {

@GetMapping("/{id}")
public String getUser(@PathVariable String id) {
return "User ID: " + id;
}
}

运行主类，启动内嵌服务器。

@SpringBootApplication
public class UserServiceApplication {
public static void main(String[] args) {
SpringApplication.run(UserServiceApplication.class, args);
}
}

访问 http://localhost:8080/users/123，得到以下响应：

User ID: 123

八、总结

Spring Boot 的内嵌服务器特性极大地简化了 Java Web 应用的开发和部署过程。通过灵活配置和支持多种服务器类型，开发者可以轻松构建和管理高性能的 Web 应用。在实际开发中，理解内嵌服务器的工作原理、配置方式以及常见问题的解决方案，是每位 Spring Boot 开发者的重要技能。