当前位置：首页 > news >正文

SpringMVC异步处理Servlet

news 2025/6/14 1:15:03

使用SpringMVC异步处理Servlet解决的问题

可以不阻塞有限的tomcat 线程（默认是200~250个，springboot3是200个），确保网络请求可以持续响应
特定业务使用自定义线程池，可以处理的业务量更大
对上层业务完全无感知（但如果中间链路有超时，则需要注意，比如 nginx 代理60秒超时）
SpringMVC 的包装比较好，可以完全无感 Servlet 的底层实现

注意事项

springboot3里面会默认开启异步，虽然官方文档说，如果使用了AbstractAnnotationConfigDispatcherServletInitializer则会开启异步支持，但我看代码并没有使用，实际也是开启的（可能还有我不懂的，比如使用了@EnableAsync注解，先保留意见）。SpringMVC 会默认将所有的 Servlet 和 Filter 都注册为支持异步，但是否需要开启异步是根据返回值的类型判断的。
官方文档说返回结果支持DeferredResult和Callable，实测其实还有其他的类型可以支持，比如CompletableFuture。
对于 Callable 的返回结果，处理流程如下：
1. 对于这个类型的返回值，Spring 会采用CallableMethodReturnValueHandler进行处理异步结果，注意这里的结果类型都是Callable。
2. CallableMethodReturnValueHandler会调用 org.springframework.web.context.request.async.WebAsyncManager#startCallableProcessing(org.springframework.web.context.request.async.WebAsyncTask<?>, java.lang.Object…)处理结果，Callable 是包装成WebAsyncTask执行的。
  1. 其中的拦截器之类的都忽略，但这有非常重要的一点this.taskExecutor.submit(() -> {});，这里是 SpringMVC 会将异步的任务提交到线程池处理，也就是调用Callable.call()来获取结果，也就意味着这个线程池是阻塞的。而 Servlet 线程会在此提交到线程池后释放（假定此处的 servlet 线程是http-nio-7001-exec-1）。
  2. 所谓释放线程，其实就是 servlet 执行结束了，然后 Filter 也会执行结束，相当于整个请求的线程执行全部结束，仅仅是，没有给 response 结果而已。
  3. 这一步的线程池taskExecutor，默认是每次new Thread 的，存在风险，需要替换为执行线程池，可以实现 MVC 配置，并指定线程池org.springframework.web.servlet.config.annotation.WebMvcConfigurer#configureAsyncSupport。
3. 在异步执行完成后，SpringMVC 会再次触发DispatcherServlet中doDispatch（这也是个坑），在这里直接将结果返回，不再执行 Controller。这是因为 Request 中已经标记request.getDispatcherType()是ASYNC值。
  1. HandlerInterceptor拦截器的实现类需要注意，因为DispatcherServlet中doDispatch会被再次调用，所以preHandle方法在一开始会调用一次，异步执行完成后，发送结果给客户端的时候会重复调用一次，如果不希望执行，可以用DispatcherType.ASYNC.equals(request.getDispatcherType())判断，并跳过执行，注意返回结果是 true即可。
  2. 再次触发的doDispatch，通常是一个新的线程（如：http-nio-7001-exec-2），因为线程不同，所以在 ThreadLocal 中存储的全链路跟踪 TraceId 会丢失，需要采用其他方式，比如放到 Request的Attribute 里面。
WebAsyncTask 和 Callable 一样，也存在线程池问题。
对于DeferredResult的返回结果，处理流程如下：
1. DeferredResultMethodReturnValueHandler
2. org.springframework.web.context.request.async.WebAsyncManager#startDeferredResultProcessing
  1. 这里没有线程池，因为DeferredResult 需要你在业务执行的地方setResult，Spring 会在setResult后触发后续链路。
CompletableFuture、Mono、Flux 返回值类型：会被认为是 Reactive 类型的返回值，通过ResponseBodyEmitterReturnValueHandler处理，最终会包装为DeferredResultSubscriber，执行到org.springframework.web.context.request.async.WebAsyncManager#startDeferredResultProcessing中，和DeferredResult的处理方式一样。
1. 注意，在handleReturnValue 中会有判断，如果异步的返回 Reactive 对象是同步完成态，比如 Mono 只有一个确定的结果，里面没有采用订阅的模式进行异步处理，或者 Future 是完结态，那么handleReturnValue 会直接同步返回结果，而不是异步处理。所以开发的时候要注意：
  1. 一定要自己启动异步线程，在Future 中做业务逻辑，比如直接用CompletableFuture.supplyAsync(()->{}, threadPool)
  2. 在Publisher.subscribe订阅的时候，启动异步线程threadPool.submit()->{ subscriber.onSubscribe(subscription); --> Subscription.request(x) --> subscriber.onNext(T); }，在异步线程中onNext时输出结果，才能确保在 Servlet 层面是异步的，非阻塞的。

结论

只有 Callable 用了简单线程池，存在线程问题，如果使用需要指定线程池，但也只有Callable使用最简单，return 即可。

另外，推荐采用DeferredResult和CompletableFuture类型的返回值，需要自己在线程池中处理业务并赋值结果。

代码示例

package com.test;import jakarta.servlet.http.HttpServletRequest;
import jakarta.servlet.http.HttpServletResponse;
import lombok.extern.slf4j.Slf4j;
import org.reactivestreams.Publisher;
import org.reactivestreams.Subscriber;
import org.reactivestreams.Subscription;
import org.springframework.scheduling.annotation.EnableAsync;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;
import org.springframework.web.context.request.async.DeferredResult;
import reactor.core.publisher.Mono;import java.util.concurrent.ArrayBlockingQueue;
import java.util.concurrent.CompletableFuture;
import java.util.concurrent.ThreadPoolExecutor;
import java.util.concurrent.TimeUnit;@Slf4j
@RestController
@RequestMapping("/restapi/testAsync")
public class TestAsyncToolboxController {private static final ThreadPoolExecutor threadPoolExecutor = new ThreadPoolExecutor(10,100,60,TimeUnit.SECONDS,new ArrayBlockingQueue<>(10000),new ThreadPoolExecutor.AbortPolicy());@RequestMapping("/test")public DeferredResult<Object> test(HttpServletRequest request, HttpServletResponse response) {log.info("TestAsyncToolboxController.test 1 isAsyncStarted={}, isAsyncSupported={}", request.isAsyncStarted(), request.isAsyncSupported());DeferredResult<Object> deferredResult = new DeferredResult<>();threadPoolExecutor.submit(() -> {try {log.info("TestAsyncToolboxController.test 2 isAsyncStarted={}, isAsyncSupported={}", request.isAsyncStarted(), request.isAsyncSupported());TimeUnit.SECONDS.sleep(5);log.info("TestAsyncToolboxController.test 3 isAsyncStarted={}, isAsyncSupported={}", request.isAsyncStarted(), request.isAsyncSupported());} catch (InterruptedException e) {deferredResult.setResult("exception");throw new RuntimeException(e);}log.info("TestAsyncToolboxController.test 4 isAsyncStarted={}, isAsyncSupported={}", request.isAsyncStarted(), request.isAsyncSupported());deferredResult.setResult("success");});return deferredResult;}@RequestMapping("/test3")public CompletableFuture<String> test3(HttpServletRequest request, HttpServletResponse response) {log.info("TestAsyncToolboxController.test3 1 isAsyncStarted={}, isAsyncSupported={}", request.isAsyncStarted(), request.isAsyncSupported());CompletableFuture<String> stringCompletableFuture = CompletableFuture.supplyAsync(() -> {try {log.info("TestAsyncToolboxController.test3 2 isAsyncStarted={}, isAsyncSupported={}", request.isAsyncStarted(), request.isAsyncSupported());TimeUnit.SECONDS.sleep(5);log.info("TestAsyncToolboxController.test3 3 isAsyncStarted={}, isAsyncSupported={}", request.isAsyncStarted(), request.isAsyncSupported());} catch (InterruptedException e) {throw new RuntimeException(e);}log.info("TestAsyncToolboxController.test3 4 isAsyncStarted={}, isAsyncSupported={}", request.isAsyncStarted(), request.isAsyncSupported());return "success";}, threadPoolExecutor);return stringCompletableFuture;}@RequestMapping("/test4")public Mono<String> test4(HttpServletRequest request, HttpServletResponse response) {log.info("TestAsyncToolboxController.test4 1 isAsyncStarted={}, isAsyncSupported={}", request.isAsyncStarted(), request.isAsyncSupported());try {return Mono.from(new Publisher<String>() {@Overridepublic void subscribe(Subscriber<? super String> subscriber) {threadPoolExecutor.submit(() -> {try {log.info("TestAsyncToolboxController.test4 2 isAsyncStarted={}, isAsyncSupported={}", request.isAsyncStarted(), request.isAsyncSupported());TimeUnit.SECONDS.sleep(5);log.info("TestAsyncToolboxController.test4 3 isAsyncStarted={}, isAsyncSupported={}", request.isAsyncStarted(), request.isAsyncSupported());} catch (InterruptedException e) {throw new RuntimeException(e);}log.info("TestAsyncToolboxController.test4 4 isAsyncStarted={}, isAsyncSupported={}", request.isAsyncStarted(), request.isAsyncSupported());Subscription subscription = new Subscription() {@Overridepublic void request(long n) {log.info("TestAsyncToolboxController.test4 7 isAsyncStarted={}, isAsyncSupported={}", request.isAsyncStarted(), request.isAsyncSupported());subscriber.onNext("success");}@Overridepublic void cancel() {log.info("TestAsyncToolboxController.test4 8 isAsyncStarted={}, isAsyncSupported={}", request.isAsyncStarted(), request.isAsyncSupported());}};log.info("TestAsyncToolboxController.test4 10 isAsyncStarted={}, isAsyncSupported={}", request.isAsyncStarted(), request.isAsyncSupported());subscriber.onSubscribe(subscription);log.info("TestAsyncToolboxController.test4 9 isAsyncStarted={}, isAsyncSupported={}", request.isAsyncStarted(), request.isAsyncSupported());});log.info("TestAsyncToolboxController.test4 6 isAsyncStarted={}, isAsyncSupported={}", request.isAsyncStarted(), request.isAsyncSupported());}});} finally {log.info("TestAsyncToolboxController.test4 5 isAsyncStarted={}, isAsyncSupported={}", request.isAsyncStarted(), request.isAsyncSupported());}}
}