SpringMVC 处理 multipart/form-data 请求

用 postman 做测试时，发现用 multipart/form-data 的格式发送请求，要么是接收不到数据，要么就是 415 错误。

出现这些问题通常是因为没有配置好 Multipart resolver 引起的。

SpringMVC 的 Multipart resolver 有两种实现

• 基于 Apache Commons FileUpload
• 基于 Servlet 3.0 的 multipart request parsing

要激活对 multipart 的处理，你需要声明一个名为 multipartResolver 的 MultipartResolver 类型的 bean。DispatcherServlet 会检测到它并会在合适的请求中使用它。比如当一个 POST 请求的 Content-type = multipart/form-data，这个 resolver 会解析请求的内容并将该请求的 HttpServletRequest 包装成 MultipartHttpServletRequest。这样我们就可以像其他的请求格式一样获取到请求参数了 。

两种配置方式

• Apache FileUpload
  仅需要声明一个名为 multipartResolver 的 CommonsMultipartResolver 类型的 bean，当然你需要引入 commons-fileupload。

• Servlet 3.0
  首先需要在 servlet 容器配置中配置

Java 的配置，注册 MultipartConfigElement

public class AppInitializer extends AbstractAnnotationConfigDispatcherServletInitializer {
     

    // ...

    @Override
    protected void customizeRegistration(ServletRegistration.Dynamic registration) {

        // Optionally also set maxFileSize, maxRequestSize, fileSizeThreshold
        registration.setMultipartConfig(new MultipartConfigElement("/tmp"));
    }

}

如果是 web.xml 的配置，在 servlet 声明中添加 节点。

配置好容器后，声明一个名为 multipartResolver 的 StandardServletMultipartResolver 类型的 bean。

参考

Spring doc