catalina_opts对spring boot内嵌tomcat的请求体大小无效，因其仅影响jvm参数，不作用于tomcat connector层；需通过server.tomcat.max-http-post-size配置或代码定制tomcatservletwebserverfactory。
Spring Boot 内嵌 Tomcat 的请求体大小限制不能靠环境变量（如 CATALINA_OPTS）生效，必须通过 Spring Boot 配置项或代码定制容器。
为什么 CATALINA_OPTS 对请求体大小无效
请求体大小（如上传文件、大 JSON）由 Servlet 容器的 maxHttpPostSize（Tomcat）、maxHttpFormPostSize 等参数控制，这些是运行时容器配置，不是 JVM 启动参数。CATALINA_OPTS 只影响 JVM 内存、系统属性等，不触达 Tomcat 的 Connector 层级配置。
- 常见错误现象：
Caused by: java.lang.IllegalArgumentException: Request body is too large或 400 错误，但改了CATALINA_OPTS毫无作用 - 根本原因：Spring Boot 自动装配的
TomcatServletWebServerFactory不读取CATALINA_OPTS中的 HTTP 协议相关设置 - 适用场景：仅当你**独立部署 WAR 包到外置 Tomcat** 时，才需在
server.xml中配maxHttpPostSize；Spring Boot 内嵌模式下这条路走不通
application.properties 中最简配置方式
Spring Boot 提供了标准化的 ServerProperties 映射，直接覆盖即可，无需写 Java 代码：
server.tomcat.max-http-post-size=10MB # 注意：单位支持 B / KB / MB / GB，不支持 "10485760"
- 该配置等价于 Tomcat
Connector的maxHttpPostSize属性 - 若用的是 Jetty 或 Undertow，对应配置前缀为
server.jetty或server.undertow，参数名不同（如max-http-form-post-size） - 注意兼容性：Spring Boot 2.3+ 默认使用 Tomcat 9.0+，
max-http-post-size是有效参数；低于 2.2 的旧版本可能需用max-http-form-post-size
需要动态调整或加日志时用代码配置
当你要在启动时校验值、打日志、或根据 profile 切换限制时，注册一个 TomcatServletWebServerFactory Bean 更可靠：
@Bean
public ServletWebServerFactory servletWebServerFactory() {
TomcatServletWebServerFactory factory = new TomcatServletWebServerFactory();
factory.addAdditionalTomcatConnectors(customConnector());
return factory;
}
<p>private Connector customConnector() {
Connector connector = new Connector("org.apache.coyote.http11.Http11NioProtocol");
connector.setPort(8081); // 可选：额外监听端口
connector.setMaxHttpPostSize(20 <em> 1024 </em> 1024); // 单位：字节
return connector;
}</p>
- 容易踩的坑：
setMaxHttpPostSize必须在Connector实例上设，不是Tomcat对象本身 - 若同时配了
application.properties和代码，代码优先级更高 - 不要漏掉
addAdditionalTomcatConnectors—— 直接 setConnector 会替换默认 Connector，导致静态资源、HTTP/2 等功能异常
真正容易被忽略的是：这个限制只对 POST（且 Content-Type: application/x-www-form-urlencoded 或 multipart/form-data）生效；纯 JSON 的 application/json 请求体大小，实际由 spring.servlet.max-request-size 控制（Spring Boot 2.6+），和 Tomcat 参数无关。
