SpringBoot部署OpenShift后大POST请求报ParameterLimitException异常如何解决

你的Spring Boot应用使用Undertow作为内置Servlet容器（报错栈全为Undertow相关类），默认表单参数上限为1000，你之前配置的是Tomcat容器的参数，完全不生效。报错触发在请求进入控制器前，是因为HiddenHttpMethodFilter尝试解析请求参数时触发了Undertow的参数数量限制。

方案1：直接在YML配置Undertow参数 #

你提到的standalone.xml中的max-parameters对应如下YML配置项，添加即可生效：

server:
  undertow:
    max-parameters: 20000 # 按需调整，建议大于你实际请求的参数数量
    max-http-post-size: 100MB # 可选，调整POST请求体大小上限

方案2：校验请求Content-Type（推荐） #

如果你的请求是JSON格式，请确保请求头Content-Type设置为application/json，避免被Undertow误识别为application/x-www-form-urlencoded表单请求，将JSON内的键值对全部统计为表单参数触发限制。

方案3：低版本Spring Boot自定义配置Bean #

如果你使用的Spring Boot版本（当前报错对应Spring Boot 2.1.x）不识别上述YML配置，可以添加自定义配置Bean硬编码设置参数：

import org.springframework.boot.web.embedded.undertow.UndertowServletWebServerFactory;
import org.springframework.boot.web.server.WebServerFactoryCustomizer;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import io.undertow.UndertowOptions;

@Configuration
public class UndertowCustomConfig {
    @Bean
    public WebServerFactoryCustomizer<UndertowServletWebServerFactory> undertowParameterCustomizer() {
        return factory -> factory.addBuilderCustomizers(
                builder -> builder.setServerOption(UndertowOptions.MAX_PARAMETERS, 20000)
        );
    }
}

如果你使用的是JBoss EAP/WildFly基础镜像部署而非Spring Boot胖Jar直接运行，需要修改镜像内的standalone.xml，可通过构建镜像时执行CLI命令、挂载配置文件的方式实现，无需修改应用代码。

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