Spring 5迁移至Spring 6：StandardServletMultipartResolver默认编码设置方案

在Spring 6中，CommonsMultipartResolver被移除，官方推荐使用基于Servlet规范的StandardServletMultipartResolver。由于后者不再提供setDefaultEncoding方法，你可以通过以下两种方式实现相同的默认编码效果：

1. 通过Servlet容器配置（推荐方式） #

StandardServletMultipartResolver依赖Servlet容器的Multipart配置来控制编码，这也是最符合规范的做法：

方式A：web.xml配置 #

如果项目仍使用web.xml，直接在DispatcherServlet的配置中添加<multipart-config>节点：

<servlet>
    <servlet-name>dispatcherServlet</servlet-name>
    <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
    <multipart-config>
        <default-encoding>UTF-8</default-encoding>
        <!-- 可按需添加其他Multipart配置，比如文件大小限制 -->
        <max-file-size>20971520</max-file-size> <!-- 20MB -->
        <max-request-size>41943040</max-request-size> <!-- 40MB -->
    </multipart-config>
</servlet>

方式B：编程式Servlet配置（Spring Boot或无web.xml场景） #

通过DispatcherServletRegistrationBean来配置Multipart的默认编码：

@Bean
public DispatcherServletRegistrationBean dispatcherServletRegistration(DispatcherServlet dispatcherServlet) {
    DispatcherServletRegistrationBean registrationBean = new DispatcherServletRegistrationBean(dispatcherServlet, "/");
    
    // 构建Multipart配置
    MultipartConfigElement multipartConfig = new MultipartConfigElement(
        null, // 临时文件存储路径，null则使用容器默认
        20971520, // 单个文件最大大小
        41943040, // 请求总大小上限
        0 // 文件写入磁盘的阈值，0则直接写入
    );
    registrationBean.setMultipartConfig(multipartConfig);
    
    // 设置默认编码
    registrationBean.setDefaultEncoding("UTF-8");
    
    return registrationBean;
}

2. 局部/全局请求编码补充配置 #

如果需要针对特定请求或全局请求处理设置编码，可以用以下方式：

局部请求指定编码 #

在@RequestParam或@RequestPart注解中显式指定编码：

@PostMapping("/upload")
public String handleFileUpload(
    @RequestParam(value = "file", encoding = "UTF-8") MultipartFile file,
    @RequestParam(value = "desc", encoding = "UTF-8") String description
) {
    // 业务处理逻辑
    return "upload-success";
}

全局请求适配器配置 #

通过RequestMappingHandlerAdapter设置全局默认编码：

@Bean
public RequestMappingHandlerAdapter requestMappingHandlerAdapter() {
    RequestMappingHandlerAdapter adapter = new RequestMappingHandlerAdapter();
    adapter.setDefaultEncoding("UTF-8");
    return adapter;
}

说明 #

Spring 6推荐使用Servlet原生的Multipart处理能力，因此优先通过Servlet容器配置编码，这能确保整个请求处理流程的编码一致性，避免第三方依赖带来的兼容性问题。

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