一、起源
1.1 两者的共同定位
Jetty 与 Undertow 在选用场景上有共同特征:
- 都强调轻量与启动速度,适合实例数量多、单实例资源受限的部署形态。
- 都提供良好的嵌入式支持,可以在代码中完整声明容器行为,适合需要定制处理链的场景。
- 都完整实现 Servlet 规范,常规业务代码无需改动即可迁移。
差别在于组织方式:Jetty 把能力拆成可启用的模块并在配置文件中组合,Undertow 把处理逻辑抽象为函数式处理器并在代码中组合。
1.2 各自的出身与影响
| 容器 | 出身 | 对设计的影响 |
|---|---|---|
| Jetty | 长期用于嵌入式与工具链场景 | 强调可嵌入、模块可裁剪、启动快 |
| Undertow | 由应用服务器项目孵化,作为其默认容器 | 强调 IO 层与业务层的分离,处理链为中间件式组合 |
出身决定了两者在文档与运维配套上的差异:Jetty 的嵌入式用法资料更集中,Undertow 的独立部署形态资料多与应用服务器绑定。
1.3 取舍
| 选择 | 获得 | 付出 |
|---|---|---|
| Jetty | 模块按需启用、嵌入式定制能力强、处理链可编程组合 | 模块与配置文件的组织需要理解,功能启用依赖模块清单 |
| Undertow | 轻量、处理链组合直观、线程模型清晰 | 独立部署的运维资料较少,配置以编程式为主 |
二、原理
2.1 Jetty 的架构
Jetty 的结构可以分为三层:
Server(生命周期与线程池的持有者)
├── Connector(接收连接,可多个)
│ └── ServerConnector:接受器线程 + 选择器线程
└── Handler(请求处理链的入口)
└── Handler 组合:按类型或按路径分发到具体处理器
└── 具体处理器(静态资源、Servlet、代理等)
| 组件 | 职责 | 关键参数 |
|---|---|---|
Server | 生命周期、线程池与连接器的持有者 | 线程池的最小与最大线程数、线程空闲超时 |
QueuedThreadPool | 业务线程池,负责处理器执行 | 最小与最大线程数、队列容量、空闲回收 |
ServerConnector | 接受连接、注册读写事件 | 接受器数量、选择器数量、空闲超时、监听地址与端口 |
Handler | 请求处理入口与组合点 | 由处理链的类型与顺序决定 |
三个设计特点:
- 线程池是显式对象,可以在配置中直接调整,业务线程数与连接器参数分开控制。
- 连接器的接受器与选择器线程独立于业务线程池,因此连接接收能力与业务处理能力可以分别评估。
- 能力通过模块启用,模块清单决定容器具备哪些功能;未启用对应模块时,相关配置无效。
2.2 Jetty 的处理链
处理链的组织方式体现了可编程性:
| 组合方式 | 行为 | 典型用途 |
|---|---|---|
| 集合式 | 依次尝试每个处理器,直到某个处理器明确处理了请求 | 多来源处理器并存 |
| 列表式 | 按顺序调用,每层可选择继续或终止 | 前置校验与后置处理 |
| 路径匹配式 | 按路径前缀分发到不同处理器 | 多应用或多路径分离 |
Servlet 支持本身也是处理链中的一环:Servlet 处理器负责按部署描述符把请求分派到 Servlet。因此在嵌入式用法中,容器行为的定制与业务 Servlet 的注册是两件独立的事。
需要注意的是,较新版本对处理接口做了重新设计,部署 Web 应用时除了启用部署模块,还需要按应用所使用的规范版本选择对应的环境模块,未启用对应模块时应用不会被部署。
2.3 Undertow 的架构
Undertow 建立在 XNIO 之上,线程分为两层:
XNIO Worker
├── IO 线程:注册与等待读写事件,把就绪事件交给业务线程
└── 业务线程(Worker 线程):执行处理器链
| 组件 | 职责 | 默认关系 |
|---|---|---|
| IO 线程 | 处理网络事件,职责单一 | 通常按处理器数量设置,默认与处理器数相关 |
| 业务线程 | 执行处理器链,包含业务逻辑 | 默认按 IO 线程数的倍数设置 |
| 缓冲池 | 每连接的读写缓冲 | 缓冲大小与是否使用直接内存可配置 |
设计含义:
- IO 线程不执行阻塞逻辑,因此阻塞业务不会直接阻塞事件处理,但如果业务线程全部阻塞,请求仍会排队。
- 业务线程数的默认值远大于 IO 线程数,反映的是"IO 密集、业务阻塞"的假设;业务为 CPU 密集型时应下调业务线程数,避免过度切换。
- 处理器链采用函数式组合,链上的每一段都可以决定是否继续传递给下一段,这与 Servlet 过滤器链的模型相似,但粒度更细,可以作用在非 Servlet 的请求上。
Servlet 支持由独立组件提供,未引入该组件时容器只提供底层处理器能力,这也是它既能承载 Servlet 应用也能作为轻量 HTTP 服务的原因。
2.4 与 Tomcat 的机制差异
| 维度 | Tomcat | Jetty | Undertow |
|---|---|---|---|
| 连接接收 | 接受器与事件轮询与业务线程池分离 | 接受器与选择器独立,业务线程池为独立对象 | IO 线程与业务线程分离 |
| 业务线程可控性 | 通过连接器属性控制线程池 | 线程池为显式对象,可直接配置 | 业务线程数可配置,默认与 IO 线程数成倍数 |
| 扩展点组织 | 阀与领域与监听器,按层次挂载 | 处理器与包装器,按链组合 | 函数式处理器,按中间件组合 |
| 配置形态 | XML 为主,结构即容器层次 | 模块清单加模块化 XML | 编程式构建为主 |
| 能力启用 | 随版本内置 | 需启用对应模块 | 由引入的组件决定 |
| 独立部署配套 | 管理入口与指标体系完整 | 提供部署与请求日志模块 | 独立部署形态资料较少 |
2.5 适用与不适用
| 容器 | 较适用 | 不适用 |
|---|---|---|
| Jetty | 嵌入式定制、需要按需裁剪能力、启动时间敏感 | 需要成熟的容器管理界面与完整运维配套 |
| Undertow | 轻量 HTTP 服务与 Servlet 混用、需要细粒度处理链控制 | 团队缺少其排障经验且依赖资料的场景 |
三、实现
3.1 Jetty 独立部署与模块启用
# 目录划分:home 存放发行版,base 存放配置与部署内容,便于版本升级
export JETTY_HOME=/opt/jetty
export JETTY_BASE=/data/jetty-base
mkdir -p "$JETTY_BASE"
cd "$JETTY_BASE"
# 初始化基础目录并启用所需能力(不同版本命令形式不同:较早版本为 --add-to-start)
java -jar "$JETTY_HOME/start.jar" --add-module=http,deploy,requestlog
# 部署 Web 应用时按规范版本启用对应环境模块(较新版本的模块命名方式)
java -jar "$JETTY_HOME/start.jar" --add-module=ee10-deploy,ee10-webapp
# 启用 HTTPS
java -jar "$JETTY_HOME/start.jar" --add-module=ssl,https
# 查看已启用模块与全部可用模块
ls "$JETTY_BASE/start.d"
java -jar "$JETTY_HOME/start.jar" --list-modules=all
# 校验配置并启动
java -jar "$JETTY_HOME/start.jar" --dry-run
java -jar "$JETTY_HOME/start.jar"
# start.d/http.ini:模块启用参数(端口与监听地址)
jetty.http.port=8080
jetty.http.host=127.0.0.1
# start.d/threadpool.ini:业务线程池参数
jetty.threadPool.minThreads=20
jetty.threadPool.maxThreads=200
jetty.threadPool.idleTimeout=60000
# 部署应用:放置到 webapps 目录,deploy 模块会扫描该目录
cp application.war "$JETTY_BASE/webapps/"
# 验证部署与访问
ls "$JETTY_BASE/webapps"
curl -sI http://127.0.0.1:8080/application/ | head -3
# 请求日志(启用 requestlog 模块后按 NCSA 格式记录)
tail -f "$JETTY_BASE/logs/yyyy_mm_dd.request.log"
3.2 Jetty 嵌入式
public class EmbeddedJettyServer {
public static void main(String[] args) throws Exception {
// 业务线程池:最小与最大线程数、空闲超时
QueuedThreadPool threadPool = new QueuedThreadPool(200, 20, 60_000);
Server server = new Server(threadPool);
// 连接器:接受器与选择器数量由构造参数决定,此处使用默认策略
HttpConfiguration httpConfig = new HttpConfiguration();
ServerConnector connector = new ServerConnector(server, new HttpConnectionFactory(httpConfig));
connector.setPort(8080);
connector.setHost("127.0.0.1");
connector.setIdleTimeout(30_000);
server.addConnector(connector);
// Servlet 上下文:按路径挂载应用
ServletContextHandler context = new ServletContextHandler();
context.setContextPath("/app");
// 注册业务 Servlet
context.addServlet(new ServletHolder(new PingServlet()), "/ping");
// 处理链:先挂载业务上下文,再由默认处理器兜底
ContextHandlerCollection contexts = new ContextHandlerCollection();
contexts.setHandlers(new Handler[]{ context });
server.setHandler(contexts);
server.start();
server.join();
}
}
要点:连接器参数与业务线程池参数分别声明,排障时可以先判断瓶颈在连接接收还是业务执行;接受器与选择器数量由连接器构造参数指定,默认按可用处理器数量计算,连接接收能力不足且业务线程空闲时才有调整价值。
3.3 Undertow 嵌入式
public class EmbeddedUndertowServer {
public static void main(String[] args) {
// IO 线程与业务线程分别配置;业务线程默认按 IO 线程数的倍数设置
Undertow server = Undertow.builder()
.addHttpListener(8080, "127.0.0.1")
.setIoThreads(4)
.setWorkerThreads(64)
.setBufferSize(16 * 1024)
.setDirectBuffers(true)
.setServerOption(UndertowOptions.NO_REQUEST_TIMEOUT, 30_000)
.setHandler(buildHandler())
.build();
server.start();
}
private static HttpHandler buildHandler() {
// 处理链:路径匹配加业务处理器,按中间件方式组合
HttpHandler business = exchange -> {
exchange.getResponseHeaders().put(Headers.CONTENT_TYPE, "text/plain; charset=utf-8");
exchange.getResponseSender().send("ok");
};
// 前置处理器:记录耗时并决定是否继续向下一段传递
HttpHandler withLogging = exchange -> {
long start = System.nanoTime();
exchange.addExchangeCompleteListener((ex, next) -> {
long cost = (System.nanoTime() - start) / 1_000_000;
System.out.println(ex.getRequestPath() + " " + cost + "ms");
next.proceed();
});
business.handleRequest(exchange);
};
return Handlers.path()
.addPrefixPath("/app", withLogging);
}
}
要点:处理器链的每一段自行决定是否调用下一段,因此中间件(鉴权、限流、日志)与业务处理器在同一层组合,不依赖 Servlet 过滤器;非 Servlet 的轻量接口可以直接用处理器实现,避免引入 Servlet 组件。
3.4 Undertow 在 Spring Boot 中的配置
server:
port: 8080
undertow:
threads:
io: 4 # 旧版本为 io-threads
worker: 64 # 旧版本为 worker-threads
buffer-size: 16KB
direct-buffers: true # 使用堆外缓冲,减少堆内存压力
max-http-post-size: 20MB
max-header-size: 16KB
no-request-timeout: 30s
always-set-keep-alive: true
accesslog:
enabled: true
dir: /var/log/application
pattern: combined
rotate: true
# 确认实际生效的容器与线程名(不同容器的线程命名不同)
java -jar application.jar --debug 2>&1 | grep -i undertow | head
jcmd $(pgrep -f 'java.*application.jar') Thread.print | grep -oE '^"[^"]*"' | sort | uniq -c | sort -rn | head
# 确认 IO 线程数与业务线程数的关系是否符合预期
jcmd $(pgrep -f 'java.*application.jar') Thread.print | grep -cE '^"XNIO-1 I/O-'
jcmd $(pgrep -f 'java.*application.jar') Thread.print | grep -cE '^"XNIO-1 task-'
# 确认访问日志已产出
ls -l /var/log/application/access*
tail -n 5 /var/log/application/access*.log
3.5 验证与观测
# 端口与监听地址
ss -tlnp | grep -E ':8080|:8443'
# 协议与响应头
curl -sI http://127.0.0.1:8080/app/ping | head -5
curl -s -o /dev/null -w '%{http_code} %{http_version}\n' http://127.0.0.1:8080/app/ping
# 长连接与空闲超时行为(对比配置值)
curl -sv http://127.0.0.1:8080/app/ping 2>&1 | grep -iE 'connection|keep-alive'
# Jetty 已启用模块与配置校验
java -jar /opt/jetty/start.jar --list-config | head -40
# 线程数与状态分布:判断业务线程是否耗尽
jcmd $(pgrep -f 'Bootstrap\|start.jar\|application.jar') Thread.print \
| grep -oE 'java.lang.Thread.State: [A-Z_]+' | sort | uniq -c | sort -rn
3.6 常见问题对照
| 现象 | 常见原因 | 处理方式 |
|---|---|---|
| Jetty 中某项功能配置无效 | 对应模块未启用 | 启用模块后重启并核对模块清单 |
| Jetty 部署 Web 应用不生效 | 未启用对应规范版本的部署与环境模块 | 按应用规范版本启用对应模块 |
| Jetty 端口配置未生效 | 参数写在错误的模块配置段中 | 核对模块参数名与所在文件 |
| Undertow 业务线程数远超预期 | 默认按 IO 线程数的倍数设置,未显式配置 | 显式声明业务线程数 |
| 业务为 CPU 密集型但线程数很高 | 默认假设为 IO 密集 | 下调业务线程数并压测确认 |
| 直接内存占用偏高 | 启用直接缓冲且缓冲数多 | 调整缓冲大小或关闭直接缓冲 |
| 未引入 Servlet 组件时接口返回错误 | 处理器链未覆盖该路径 | 补齐路径匹配或引入 Servlet 组件 |
| 访问日志未产出 | 对应模块或配置未启用 | 启用请求日志模块或访问日志配置 |
| 长连接被提前关闭 | 空闲超时小于代理层的空闲超时 | 调整容器空闲超时大于代理超时 |
| 迁移后监控为空 | 指标名称随容器变化 | 更新采集规则与看板 |
四、总结
- Jetty 与 Undertow 的共同定位是轻量与可编程,差别在于 Jetty 以模块与处理链组合能力,Undertow 以函数式处理器与中间件方式组合。
- Jetty 的结构为 Server 与 Connector 与 Handler 三层,业务线程池是显式对象,连接器的接受器与选择器独立于业务线程。
- Jetty 的能力通过模块启用,未启用模块时相关配置静默无效;较新版本中部署 Web 应用还需按规范版本选择对应的环境模块。
- Jetty 的处理链支持集合式、列表式与路径匹配式组合,Servlet 支持本身也是处理链中的一环。
- Undertow 建立在 XNIO 之上,IO 线程只处理网络事件,业务线程执行处理器链,业务线程数默认按 IO 线程数的倍数设置。
- Undertow 的默认线程配比假设业务为 IO 密集,CPU 密集型业务应下调业务线程数,避免过度切换。
- Undertow 的 Servlet 支持由独立组件提供,未引入时容器可作为轻量 HTTP 服务使用,这是它与另外两者在定位上的差异。
- 三款容器的差异集中在连接接收的组织方式、业务线程的可控性、扩展点的组织方式与配置形态,而非规范兼容性。
- Jetty 与 Undertow 在独立部署形态下的运维配套弱于默认容器,选择前需确认团队的排障与监控适配成本。
- 迁移到任一容器后,需要重新核对参数生效情况、线程命名、日志产出、空闲超时与监控指标,这些项在配置正确的前提下仍可能因默认值差异而偏离预期。