Spring Cloud Netflix Zuul大文件上传Multipart参数丢失问题求助

我来帮你搞定这个大文件上传时的参数缺失问题，这种场景在Zuul处理大体积Multipart请求时确实容易踩坑，咱们一步步来排查解决：

1. 禁用Zuul自身的Multipart解析（关键步骤） #

Zuul默认会尝试解析Multipart请求，但处理大文件时，这个解析过程可能会导致请求部分丢失，后端服务就拿不到string参数了。你需要在Zuul服务的配置文件里关闭这个自动处理：

zuul:
  # 保持你原来的servlet-path配置
  servlet-path: /zuul
  # 禁用Zuul的Multipart请求解析，让请求直接透传给后端datastore服务
  multipart:
    enabled: false

这样配置后，Zuul会把原始的Multipart请求完整转发到后端，由datastore自己来解析请求中的文件和文本参数。

2. 确认后端datastore的Multipart与Tomcat配置 #

除了你已经配置的max-file-size和max-request-size，还要补充Tomcat的相关配置，避免大请求被截断：

spring:
  servlet:
    multipart:
      max-file-size: 1000MB
      max-request-size: 1000MB
      enabled: true
      file-size-threshold: 0 # 直接将文件写入磁盘，避免内存溢出
server:
  tomcat:
    max-swallow-size: -1 # 禁用Tomcat的请求体截断限制，防止大文件请求被中途丢弃
    max-http-post-size: 1048576000 # 1000MB，与multipart的max-request-size保持一致
    connection-timeout: 600000 # 延长连接超时时间，比如设置为10分钟，避免大文件上传超时

同时检查datastore的控制器方法，确保参数注解的名称和请求中的参数名完全匹配，比如：

@PostMapping("/my/upload/endpoint")
public ResponseEntity<?> uploadFile(
    @RequestParam("string") String textParam,
    @RequestParam("file") MultipartFile file) {
    // 你的业务逻辑
}

3. 移除自定义的CommonsMultipartResolver #

Spring Boot默认使用StandardServletMultipartResolver来处理Multipart请求，手动添加CommonsMultipartResolver可能会和默认解析器产生冲突，导致请求解析异常。所以请删除你之前添加的CommonsMultipartResolver相关配置，让Spring Boot使用默认的解析器即可。

4. 验证配置 #

完成以上配置后，重启Zuul和datastore服务，再次尝试上传150MB的文件，应该就能正常获取到string参数并完成文件上传了。

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