Spring Boot上传超100MB文件时提示缺少必填请求参数resourceId

这个报错不是前端真的漏传resourceId参数，核心是文件上传大小超过了服务端默认的multipart请求解析阈值，导致请求解析流程被提前中断：

• Spring Boot内置的文件上传组件默认对单文件、总请求大小有上限限制，当上传文件体积超过阈值时，框架不会完整解析整个multipart请求体，自然读不到同请求里携带的普通表单参数resourceId，最终抛出参数不存在的错误。
• 小文件上传时体积未触发阈值，请求体可以被完整解析，因此接口可以正常运行。
• 如果服务端前置了Nginx、流量网关等组件，也可能是这些组件的请求大小限制提前拦截了请求，导致后端收到的请求不完整。

1. 调整Spring Boot内置Multipart配置 #

在项目的application.yml配置文件中添加/修改如下配置，根据实际业务需求调整大小阈值：

spring:
  servlet:
    multipart:
      enabled: true
      # 单个上传文件的最大允许大小
      max-file-size: 500MB
      # 整个HTTP请求的最大允许大小（需略大于单文件上限，预留其他参数的空间）
      max-request-size: 520MB
      # 文件超过该大小时写入磁盘临时目录，避免内存溢出
      file-size-threshold: 2MB

如果使用properties格式配置，对应配置为：

spring.servlet.multipart.enabled=true
spring.servlet.multipart.max-file-size=500MB
spring.servlet.multipart.max-request-size=520MB
spring.servlet.multipart.file-size-threshold=2MB

2. 外置容器/网关层同步调整限制 #

• 如果使用外置Tomcat部署，需要修改Tomcat配置目录下的server.xml，在Connector节点添加配置取消大小拦截：

<Connector port="8080" protocol="HTTP/1.1"
           connectionTimeout="20000"
           redirectPort="8443"
           maxPostSize="-1"
           maxSwallowSize="-1"/>

其中maxPostSize="-1"表示不限制POST请求体大小，maxSwallowSize="-1"表示取消Tomcat对上传请求的吞入大小限制。

• 如果请求经过Nginx转发，需要在Nginx对应站点的配置块中添加client_max_body_size 600M;，调整Nginx允许的最大请求体大小。
• 如果使用Spring Cloud Gateway等API网关组件，也需要同步修改网关层的请求体大小限制配置，避免网关提前拦截请求。

3. 异常提示优化（可选） #

可以在全局异常处理器中单独捕获文件大小超限的异常，返回明确的“上传文件超过大小限制”类提示，避免出现误导性的"参数不存在"报错。

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