一、起源

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 组件
访问日志未产出 对应模块或配置未启用 启用请求日志模块或访问日志配置
长连接被提前关闭 空闲超时小于代理层的空闲超时 调整容器空闲超时大于代理超时
迁移后监控为空 指标名称随容器变化 更新采集规则与看板

四、总结

  1. Jetty 与 Undertow 的共同定位是轻量与可编程,差别在于 Jetty 以模块与处理链组合能力,Undertow 以函数式处理器与中间件方式组合。
  2. Jetty 的结构为 Server 与 Connector 与 Handler 三层,业务线程池是显式对象,连接器的接受器与选择器独立于业务线程。
  3. Jetty 的能力通过模块启用,未启用模块时相关配置静默无效;较新版本中部署 Web 应用还需按规范版本选择对应的环境模块。
  4. Jetty 的处理链支持集合式、列表式与路径匹配式组合,Servlet 支持本身也是处理链中的一环。
  5. Undertow 建立在 XNIO 之上,IO 线程只处理网络事件,业务线程执行处理器链,业务线程数默认按 IO 线程数的倍数设置。
  6. Undertow 的默认线程配比假设业务为 IO 密集,CPU 密集型业务应下调业务线程数,避免过度切换。
  7. Undertow 的 Servlet 支持由独立组件提供,未引入时容器可作为轻量 HTTP 服务使用,这是它与另外两者在定位上的差异。
  8. 三款容器的差异集中在连接接收的组织方式、业务线程的可控性、扩展点的组织方式与配置形态,而非规范兼容性。
  9. Jetty 与 Undertow 在独立部署形态下的运维配套弱于默认容器,选择前需确认团队的排障与监控适配成本。
  10. 迁移到任一容器后,需要重新核对参数生效情况、线程命名、日志产出、空闲超时与监控指标,这些项在配置正确的前提下仍可能因默认值差异而偏离预期。