Tomcat NIO Connector线程阻塞疑问：为何未异步处理请求

问题场景 #

用Scala结合Jersey开发服务，配置了Tomcat NIO连接器（10个线程），预期连接器线程在请求处理IO/调用依赖服务时不会阻塞，能去处理其他请求，耗时逻辑交给Scala独立执行上下文。但实验时发现，哪怕把耗时操作放到独立线程里，连接器线程还是会一直等请求完成，没法处理其他请求。

参考代码片段：

def ping(request: HttpServletRequest, asyncResponse: AsyncResponse): Unit = {
  implicit val ec: ExecutionContext = CustomExecutionContext.executionContext
  println("This thread is parked until following future is completed")
  Future {
    println("This future is being executed on dedicated execution context")
    Thread.sleep(5000)
    asyncResponse.resume(HttpResponses.ok)
  }(ec)
}

误区与原因 #

你对Tomcat NIO连接器的核心逻辑理解没错，但没正确触发Jersey/Tomcat的异步请求处理模式，导致连接器线程被绑定到当前请求直到处理完成。

Tomcat NIO连接器的非阻塞能力是针对网络IO层面的（比如等待客户端发请求、给客户端回响应），但请求处理阶段如果不明确开启Servlet异步模式，容器会默认按同步方式处理——连接器线程会一直绑定到当前请求，直到整个请求逻辑执行完毕才会被释放。

你的代码虽然用Scala Future把耗时逻辑放到了独立线程，但没告诉容器“这个请求要异步处理”。默认情况下，Jersey会等待资源方法执行结束才标记请求处理完成，而如果没挂起AsyncResponse，容器还是会认为当前连接器线程需要负责整个请求的收尾，不会释放它去处理其他请求。

修正方案 #

在创建异步Future之前，主动调用asyncResponse.suspend()来明确告知容器进入异步模式，释放连接器线程：

def ping(request: HttpServletRequest, asyncResponse: AsyncResponse): Unit = {
  implicit val ec: ExecutionContext = CustomExecutionContext.executionContext
  // 挂起异步响应，释放连接器线程
  asyncResponse.suspend()
  println("连接器线程已释放，可处理其他请求")
  Future {
    println("耗时逻辑在独立执行上下文运行")
    Thread.sleep(5000)
    asyncResponse.resume(HttpResponses.ok)
  }(ec)
}

另外还要确认两个配置：

• Tomcat的NIO连接器开启了异步支持：检查server.xml中的连接器配置，确保包含asyncTimeout参数（比如<Connector ... protocol="org.apache.coyote.http11.Http11NioProtocol" asyncTimeout="30000"/>），默认是开启的。
• Jersey启用了异步处理：如果用ResourceConfig配置Jersey，可注册AsyncFeature（多数场景下默认已支持）。

补充说明 #

Tomcat NIO连接器的作用是解决网络IO阶段的阻塞问题，而请求处理阶段的异步需要依赖Servlet异步模式配合——释放连接器线程后，线程可以去处理其他请求，耗时逻辑在独立线程池执行，完成后再通过AsyncResponse.resume()返回结果，这样才能真正实现非阻塞的请求处理。

内容的提问来源于stack exchange，提问作者Aamir