如何在SpringBoot/AWS EC2中设置HTTP POST请求的最大内容长度？

1. Spring Boot YAML配置调整 #

直接在application.yml中添加以下配置，覆盖默认的内容长度限制：

spring:
  # 处理Multipart类型请求（如文件上传）的大小限制
  servlet:
    multipart:
      max-file-size: 100MB       # 单个文件的最大允许大小
      max-request-size: 200MB    # 整个请求的总内容大小限制
  # 内嵌Tomcat专属配置
  tomcat:
    max-swallow-size: -1         # 禁用Tomcat对过大请求体的截断，-1表示无限制
    max-http-form-post-size: 200MB  # 普通表单POST请求的最大内容长度

注：可根据实际业务需求调整数值，比如将100MB改为500MB或更大。

2. 内嵌Tomcat额外配置（若YAML不生效） #

如果上述YAML配置未生效，可通过自定义配置类强制修改Tomcat参数：

import org.springframework.boot.web.embedded.tomcat.TomcatServletWebServerFactory;
import org.springframework.boot.web.server.WebServerFactoryCustomizer;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Configuration
public class TomcatConfig {
    @Bean
    public WebServerFactoryCustomizer<TomcatServletWebServerFactory> tomcatCustomizer() {
        return factory -> {
            factory.addConnectorCustomizers(connector -> {
                // 设置普通POST请求的最大内容长度，-1表示无限制
                connector.setMaxPostSize(-1);
                // 处理异步请求的内容吞入限制
                connector.setAttribute("maxSwallowSize", -1);
            });
        };
    }
}

3. AWS环境侧限制排查 #

本地正常但AWS报错，大概率是AWS服务的默认限制，需检查以下几点：

• API Gateway：默认最大请求payload为10MB，需在API Gateway控制台的「API设置」中修改「Payload Size」，最大可设为10GB。
• Application Load Balancer（ALB）：默认请求体大小限制为1MB，需在ALB的监听器规则中调整「Maximum request body size」参数，最大支持1GB。
• EC2独立Tomcat：若部署在EC2的独立Tomcat（非Spring内嵌），需修改server.xml的Connector节点，添加maxPostSize="-1"：

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

4. 大内容场景替代方案：分块上传 #

如果请求内容超过1GB，不建议直接调整单请求大小限制（会影响服务稳定性），推荐使用分块上传：

• 将大内容拆分为多个小片段（如每个片段10MB），逐个发送请求。
• 服务端接收所有片段后，再拼接成完整内容。
• 若内容为文件，可直接使用AWS S3的分块上传API，无需自己实现拼接逻辑。

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