使用 Spring 处理 MultipartException 启动并显示错误页面

Handling MultipartException with Spring Boot and display error page

我有一个非常简单的文件上传设置 Spring Boot. 我想知道是否有一种简单的方法可以在超过最大文件大小时显示错误页面。

我已经上传了一个非常简单的示例,说明了我要实现的目标 on github

基本上,想法是在全局 Spring 异常处理程序中捕获 MultipartException:

@ControllerAdvice
public class UploadExceptionHandler {

  @ExceptionHandler(MultipartException.class)
  public ModelAndView handleError(MultipartException exception) {
    ModelAndView modelAndView = new ModelAndView();
    modelAndView.addObject("error", exception.getMessage());
    modelAndView.setViewName("uploadPage");
    return modelAndView;
  }
}

处理文件上传的控制器非常简单:

@RequestMapping("/")
public String uploadPage() {
    return "uploadPage";
}

@RequestMapping(value = "/", method = RequestMethod.POST)
public String onUpload(@RequestParam MultipartFile file) {
    System.out.println(file.getOriginalFilename());
    return "uploadPage";
}

还有与之关联的 uploadPage.html thymeleaf 模板:

<!DOCTYPE html>
<html xmlns:th="http://www.thymeleaf.org">
<head lang="en">
    <title>Upload</title>
</head>
<body>

<div style="color: red" th:text="${error}" th:if="${error}">
    Error during upload
</div>

<form th:action="@{/}" method="post" enctype="multipart/form-data">
  <input type="file" id="file" name="file"/>
  <button type="submit" name="save">Submit</button>
</form>
</body>
</html>

想法是当文件太大时在同一个上传页面显示错误信息。

据我了解,人们会配置 Spring 的 MultipartResolver 以延迟解决异常,并能够在 Spring 级别(MVC 异常处理程序)捕获这些异常,但这段代码确实如此似乎没有帮助:

@Bean(name = DispatcherServlet.MULTIPART_RESOLVER_BEAN_NAME)
public StandardServletMultipartResolver multipartResolver() {
    StandardServletMultipartResolver multipartResolver = new StandardServletMultipartResolver();
    multipartResolver.setResolveLazily(true);
    return multipartResolver;
}

因此,在我采取极端措施(如过滤器或扩展 MultipartResolver)之前...

您知道使用 Spring MVC 处理这些异常的简洁方法吗?

回答

感谢@rossen-stoyanchev。 这是我最后做的:

@RequestMapping("uploadError")
public ModelAndView onUploadError(HttpServletRequest request) {
    ModelAndView modelAndView = new ModelAndView("uploadPage");
    modelAndView.addObject("error", request.getAttribute(WebUtils.ERROR_MESSAGE_ATTRIBUTE));
    return modelAndView;
}

@Bean
public EmbeddedServletContainerCustomizer containerCustomizer() {
    return container -> container.addErrorPages(new ErrorPage(MultipartException.class, "/uploadError"));
}

像魅力一样工作,感觉就像一个优雅的解决方案。 如果有人感兴趣,我会在 github 上更新项目。 非常感谢!

多部分请求解析发生在选择处理程序之前,因此没有@Controller,因此还没有@ControllerAdvice 可言。您可以为此使用 ErrorController(参见 http://docs.spring.io/spring-boot/docs/current/reference/html/boot-features-developing-web-applications.html#boot-features-error-handling)。

顺便说一句,你不需要@RequestParam。参数类型是 MultipartFile 就足够了。