使用Spring Cloud Zuul代理文件上传API遇EOFException及MultipartException问题

我之前在做文件上传网关转发的时候也碰到过一模一样的问题，这个EOFException加MultipartException的组合，基本上都是Zuul在转发multipart请求时的配置或者流处理出了问题，给你几个靠谱的解决步骤：

• 调整Zuul和Multipart核心配置
  首先在网关的application.yml（或application.properties）里配置好multipart支持和Zuul的超时参数，避免因为请求体未完整转发或超时导致EOF：

  spring:
    servlet:
      multipart:
        enabled: true
        max-file-size: 10MB  # 根据你的业务实际调整大小
        max-request-size: 10MB
  zuul:
    servlet-path: /
    host:
      max-total-connections: 200
      max-per-route-connections: 20
      socket-timeout-millis: 60000  # 延长socket超时时间，避免大文件上传中途中断
      connect-timeout-millis: 60000
  

  这里的servlet-path: /是让Zuul直接处理根路径下的所有请求，确保multipart请求能被正确拦截并转发。

• 手动配置Multipart解析器（针对Zuul 1.x）
  如果上面的配置还没解决问题，可以在网关服务里添加一个手动的Multipart配置类，强制指定解析规则：

  @Configuration
  public class MultipartConfig {
      @Bean
      public MultipartConfigElement multipartConfigElement() {
          MultipartConfigFactory factory = new MultipartConfigFactory();
          // 设置文件和请求体的最大大小，和yaml配置保持一致
          factory.setMaxFileSize(DataSize.ofMegabytes(10));
          factory.setMaxRequestSize(DataSize.ofMegabytes(10));
          return factory.createMultipartConfig();
      }
  }
  

• 确保后端API服务的Multipart配置匹配
  别忽略后端API服务的配置，要保证后端的spring.servlet.multipart.max-file-size和max-request-size值大于或等于网关的设置，不然后端会因为文件大小超限抛出异常，也会表现为类似的错误日志。

• 禁用Spring Boot自动Multipart配置（Spring Boot 2.x专属）
  如果你的网关用的是Spring Boot 2.x版本，可能会和Zuul的multipart处理冲突——Spring Boot的自动配置会先解析multipart请求，导致Zuul拿到的是已经被处理过的请求流，转发给后端时就会出现EOF。解决方法是在网关启动类里排除自动配置：

  @SpringBootApplication(exclude = MultipartAutoConfiguration.class)
  public class ZuulGatewayApplication {
      public static void main(String[] args) {
          SpringApplication.run(ZuulGatewayApplication.class, args);
      }
  }
  

• 检查Zuul路由的Header转发设置
  有时候Zuul会过滤掉一些关键的请求头（比如Content-Type），导致后端无法识别multipart请求。可以在路由配置里允许所有敏感头转发：

  zuul:
    routes:
      upload-api:
        path: /upload/**
        service-id: your-upload-service-id
        sensitive-headers: '*'  # 允许所有头转发，或者明确指定Content-Type等关键头
  

按这个顺序排查下来，基本能解决问题。我当时是因为Spring Boot 2.x的自动配置冲突，加上超时时间设置太短导致的，禁用自动配置+延长超时就搞定了。

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