Netflix Zuul1使用Zuul前缀时Multipart大文件上传异常求助

核心原因 #

Netflix Zuul 1中，/zuul前缀的请求会绕过Spring MVC的DispatcherServlet，直接由ZuulServlet处理。而ZuulServlet的Multipart文件上传配置与DispatcherServlet完全独立，默认的缓冲区、大小限制无法适配大文件上传，导致响应异常；当设置zuul.servlet-path = /后，所有请求都走ZuulServlet，彻底丢失了DispatcherServlet的Multipart处理能力，因此全部请求出现异常。

具体解决步骤 #

1. 单独配置ZuulServlet的Multipart参数

由于/zuul前缀请求不走DispatcherServlet，Spring的spring.servlet.multipart.*配置对其无效，需直接配置Zuul专属的文件大小限制：

zuul:
  max-file-size: 100MB    # 单个文件最大大小，根据业务调整
  max-request-size: 100MB # 整个请求体最大大小，需大于等于max-file-size

同时调整Tomcat的响应吞入限制（大文件上传时，若后端中断请求，Tomcat默认会限制吞入的响应数据量，易引发Nginx超时）：

server:
  tomcat:
    max-swallow-size: -1 # 禁用限制，或设置为与max-request-size匹配的值

2. 恢复默认的Zuul Servlet路径

不要设置zuul.servlet-path = /，保持默认的/zuul前缀。这样：

• 不带/zuul的请求走DispatcherServlet，复用其成熟的Multipart处理逻辑；
• 带/zuul的请求走ZuulServlet，使用上述单独配置的参数处理大文件。

3. 自定义ZuulServlet的Multipart配置（可选，增强控制）

如果上述yaml配置不生效，可以通过代码手动注册ZuulServlet并绑定Multipart配置：

@Configuration
public class ZuulConfig {
    @Bean
    public ServletRegistrationBean<ZuulServlet> zuulServlet() {
        ServletRegistrationBean<ZuulServlet> registrationBean = new ServletRegistrationBean<>(new ZuulServlet(), "/zuul/*");
        
        // 绑定Multipart配置参数
        MultipartConfigElement multipartConfig = new MultipartConfigElement(
                null,
                100 * 1024 * 1024, // maxFileSize
                100 * 1024 * 1024, // maxRequestSize
                0 // 文件大小阈值，超过则写入磁盘
        );
        registrationBean.setMultipartConfig(multipartConfig);
        
        return registrationBean;
    }
}

4. 调整Nginx超时配置

大文件上传需要足够的请求处理时间，需同步修改Nginx的相关参数：

server {
    client_max_body_size 100M; # 与后端配置的max-request-size一致
    
    location / {
        proxy_connect_timeout 300s;
        proxy_send_timeout 300s;
        proxy_read_timeout 300s; # 延长超时时间，适配大文件上传
        proxy_pass http://zuul-proxy;
    }
}

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