java.lang.IllegalStateException: Cannot call sendError() after the response has been committed解读

源代码：

@Override

public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler)

    throws Exception {

    String uri = request.getRequestURI();

    if(pathMatcher.match("/", uri)) {

        System.err.println("跳转");

        response.sendRedirect("/swagger-ui.html");

        // return false;    // 如果此处不返回false, 则springMvc会继续对“/”路径进行处理，就会出现多次返回响应的错误。

    }

    return true;

}

注：此处对“/”路径的访问返回404.

DispatcherServlet.doDispatch()中对拦截器的preHandle进行调用：

// 如果拦截器的PreHandle返回false，则此处直接返回退出方法。

if(!mappedHandler.applyPreHandle(request,response)){

    return ;

}

// Actually invoke the handler. 调用处理器

mv = ha.handle(processedRequest, response, mappedHandler.getHandler());

// 由此处可知如果拦截器的preHandle方法返回false则不会调用处理器（控制器类的方法）

mappedHandler是一个HandlerExcutionChain对象由HandlerMapping返回，HandlerExcutionChain包含一个Handler(处理器对象)和拦截器数组，通过applyPreHandle(request,response)方法会对拦截器数组中的每一个拦截器的preHandle进行调用。

// HandlerExcutionChain类

boolean applyPreHandle(HttpServletRequest request, HttpServletResponse response) throws Exception {

    HandlerInterceptor[] interceptors = getInterceptors();

    if (!ObjectUtils.isEmpty(interceptors)) {

        for (int i = 0; i < interceptors.length; i++) {

            HandlerInterceptor interceptor = interceptors[i];

            if (!interceptor.preHandle(request, response, this.handler)) {

                triggerAfterCompletion(request, response, null);

                return false;

            }

            this.interceptorIndex = i;

        }

    }

    return true;

}

在本例中出现上述错误的原因：

拦截器拦截了对“/”路径的请求，并且调用response.sendRedirect("/swagger-ui.html")返回了响应。由于拦截器没有返回false,所以SpringMVC会继续对“/”路径进行处理。

在没有找到“/”对应的处理器时，SpringMVC默认会使用ResourceHttpRequestHandler进行请求处理。ResourceHttpRequestHandler在进行请求处理时会进行404检查，如果路径或资源不存在则会调用response.sendError(HttpServletResponse.SC_NOT_FOUND);源码如下：

// ResourceHttpRequestHandler中进行404检查

// For very general mappings (e.g. "/") we need to check 404 first

Resource resource = getResource(request);

if (resource == null) {

    logger.debug("Resource not found");

    response.sendError(HttpServletResponse.SC_NOT_FOUND);

    return;

}

由2可知，如果资源不存在就会调用response.sendError(HttpServletResponse.SC_NOT_FOUND);而在拦截器中已经调用response.sendRedirect("/swagger-ui.html")对响应进行了返回，所以就会出现多次返回响应的错误。

对于上述问题的解决办法是在response.sendRedirect("/swagger-ui.html");后返回false，或者将拦截路径由“/”改为response.sendError(HttpServletResponse.SC_NOT_FOUND);后的路径（在此处为“/error”）。

@Override

public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler)

    throws Exception {

    String uri = request.getRequestURI();

    if(pathMatcher.match("/", uri)) {

        response.sendRedirect("/swagger-ui.html");

        return false;    // 如果此处不返回false, 则springMvc会继续对“/”路径进行处理，就会出现多次返回响应的错误。

    }

    return true;

}

@Override

public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler)

    throws Exception {

    String uri = request.getRequestURI();

    if(pathMatcher.match("/error", uri)) {

        response.sendRedirect("/swagger-ui.html");

    }

    return true;

}

下面是SpringMVC处理"/api/test/error"请求时打印的部分日志（/api/test/error没有对应的处理器，即该路径不存在，报404错误）：

注：自定义的拦截器是在映射结束后才执行的。

// 请求路径

2019-02-20 14:55:57.086 DEBUG 2676 --- [nio-8080-exec-1] o.s.web.servlet.DispatcherServlet        : GET "/api/test/error", parameters={}

// 处理器映射器和请求路径对应的处理器

2019-02-20 14:55:57.092 DEBUG 2676 --- [nio-8080-exec-1] o.s.w.s.handler.SimpleUrlHandlerMapping  : Mapped to ResourceHttpRequestHandler ["classpath:/META-INF/resources/", "classpath:/resources/", "classpath:/static/", "classpath:/public/", "/"]

// 处理结果

2019-02-20 14:55:57.094 DEBUG 2676 --- [nio-8080-exec-1] o.s.w.s.r.ResourceHttpRequestHandler     : Resource not found

2019-02-20 14:55:57.095 DEBUG 2676 --- [nio-8080-exec-1] o.s.web.servlet.DispatcherServlet        : Completed 404 NOT_FOUND

下面是SpringMVC处理“/api/test/error1”请求时打印的部分日志（/api/test/error1对应的处理器在org.lwt.controller.RoleController类下的.ErrorTest()方法）：

// 请求路径

2019-02-20 15:13:23.860 DEBUG 2676 --- [nio-8080-exec-5] o.s.web.servlet.DispatcherServlet        : GET "/api/test/error1", parameters={}

// 处理器映射器和请求路径对应的处理器

2019-02-20 15:13:23.861 DEBUG 2676 --- [nio-8080-exec-5] s.w.s.m.m.a.RequestMappingHandlerMapping : Mapped to public org.lwt.vo.Result<java.lang.String> org.lwt.controller.RoleController.ErrorTest()

拦截器调用

// 处理结果

2019-02-20 15:13:23.865 DEBUG 2676 --- [nio-8080-exec-5] o.s.web.servlet.DispatcherServlet        : Failed to complete request: org.joda.time.IllegalInstantException: 自己抛出错误

2019-02-20 15:13:23.867 ERROR 2676 --- [nio-8080-exec-5] o.a.c.c.C.[.[.[/].[dispatcherServlet]    : Servlet.service() for servlet [dispatcherServlet] in context with path [] threw exception [Request processing failed; nested exception is org.joda.time.IllegalInstantException: 自己抛出错误] with root cause

// RoleController类

@RestController

@RequestMapping("/api")

@Api

public class RoleController {

    // /api/test/error1对应的处理器

    @GetMapping("/test/error1")

    public Result<String> ErrorTest(){

        throw new IllegalInstantException("自己抛出错误");

        // return Result.success("多参数传递");

    }

}

下面是SpringMVC处理“/api/test/error1”请求时打印的部分日志（/api/test/error1对应的处理器在org.lwt.controller.RoleController类下的.ErrorTest()方法）：

此处和上一次调用的区别是此次调用处理器没有报错：

// 请求路径

2019-02-20 15:21:31.440 DEBUG 8252 --- [nio-8080-exec-1] o.s.web.servlet.DispatcherServlet        : GET "/api/test/error1", parameters={}

// 处理器映射器和请求路径对应的处理器

2019-02-20 15:21:31.444 DEBUG 8252 --- [nio-8080-exec-1] s.w.s.m.m.a.RequestMappingHandlerMapping : Mapped to public org.lwt.vo.Result<java.lang.String> org.lwt.controller.RoleController.ErrorTest()

拦截器中的uri: /api/test/error1

// 处理结果

2019-02-20 15:21:31.473 DEBUG 8252 --- [nio-8080-exec-1] m.m.a.RequestResponseBodyMethodProcessor : Using 'application/json;q=0.8', given [text/html, application/xhtml+xml, image/webp, image/apng, application/xml;q=0.9, */*;q=0.8] and supported [application/json, application/*+json, application/json, application/*+json]

2019-02-20 15:21:31.473 DEBUG 8252 --- [nio-8080-exec-1] m.m.a.RequestResponseBodyMethodProcessor : Writing [org.lwt.vo.Result@334348d5]

2019-02-20 15:21:31.486 DEBUG 8252 --- [nio-8080-exec-1] o.s.web.servlet.DispatcherServlet        : Completed 200 OK

巴特西

java.lang.IllegalStateException: Cannot call sendError() after the response has been committed解读

最新文章

热门文章